SYSTEMS COMMUNICATIGNS MODULE 


s  @ Hon nm sat os mt me Haat non 


a | tt. ao ag na 
ee ae: | n : a @ oa nan a 
rr a: u | n 
1 antud nanuna «x is] 


Software Cperationat Guide 


Preliminary 


13 September 1978 


80 60 08 06 88 08 08 80 06 28 08 20 © 88 06 86 06 08 of 88 60 


: oe ee @0@ 80 8 $86 #0 oe 08 


 PLRROUGHS CORPORATION 


COMPUTER SYSTEMS GROUP — 


SANTA BARBARA PLANT 


B1800/81700 Series 


Systems . 


Company Confidential 


CHES EEEEE ED EEE TEETER EAE EE EEE EEE EEE EEE OEEE EEE EEE OEE EOE EEE DELLE EES 


++ roe reer rere + + 


TEES EEO EEEE OEE EEE EE TEESE OEEEON EN EERE EESEOOMES SESE ENTE EE OEEE EES 


+ 
+ 
4 
4 

+ 
+ 
+ 
+ 


Titles SYSTEMS COMMUNICATION | MCOULE 
Identity: Software Operational Guide 


Burroughs. Corporation bélieves the information described 
in this document to be accurate and. —retliable,s and much 
care has been taken in its preparation. However» the 


Corporation cannot accept. any responsibility» financial 
or otherwises for any consequences arising out of the use. 
of this material. = The information contained herein is 
subject to change. Revisions may be issued from time to 


time to . edvuse of such enone? and/or. acditions. 


HEREEEEOEE TEER SERRE EEE TEFL EE EEEEEEEEE TER OEEEEEOEEEEEEEEREE EEE GS 


Releases : tevet Kunber ae oo | 
; Revision Level Original 
Date of Release 7 13 Sep 1978 
; 0 Pri 12 Sep 1978. 
1 Number a = Pretiminary 


WeSeSRcUSUSECSCESSSCOSELICLILICECSSOECOSOOSCSSISECCOSEIOSION 


+ 
+ 
& 
+ 
ry 
+ 
4 
. 
- 
+ 
+ 
+ 
¢ 
+ 


aa 
4 
+ 
o& 
+ 
+ 
+ 
¢ 


B1800/81709 SYSTEMS COMMUNICATICGNS MODULE | 12 Sep 1978 
Software Operational Guide | — ) Page - iii 
Preliminary Documentation | | . Ss  COriginal Version). 


TABLE OF CONTENTS 


| PREFACE — 
MANUAL COJECTIVES AND REACER ASSUMPTIONS. Soe Sha cee 1 
STRUCTURE OF DOCUMENT ee ee ee ee ee ae - 2 
SECTION I 
INTROLUCTION TO SYCGY. 

GENERAL DESCRIPTICN a Se a ee ee ee ee Se = 

SCOPE AND OBJECTIVES. «eee ee ee ee eee er 

FUNCTIONS PERFORMED 2 2 2 2 2 ee ee ew ee ee ee a 6 

BASIC FEATURES. 2 ee ee ee ee ee ee ee eee OT 

LINE THROUGHPUT . ee Nan a Be . re ee as : eects 2 8 
ERROR DETECTICN AND RECOVERY. 2 2 2 ee oa ee 5 te ke 

LIMITATIONS . ~~ « eee Cokes Sheeneree 

NOTICE. . eke eee Se Se oe es ee ee 9 

ASSUCIATED DOCUMENTATION. . « « ae se ee eS ee . : 10 

SECTION IT 
CONCEPTS AND FACILITIES 
GENERAL DESCRIPTION « SoG Pe ae oe eee ee 12 
THE “SYSTEM CONFIGURATION. « (ae 6 a ae es Ce 

SYSTEM COMMUNICATIONS: Dee. wt be we, Gia Gate oe ees Se 
Point- to-Point Switched Network eee °° ede a ie ss are 
Point =to= Point: Non-switched Network . «© eo ee jee ° 16 

Communications “Procedure. . © 8 © « oe Sait at ee -B °° 17 
“User System - Senues system Relationshie. « « . ‘ “aa. es 


svcon AND. ITs ENVIRONMENT eee ee or 


81800781700 5 SYSTEMS: “COMMUNICATIONS MODULE eee 12 Sep , 1978 


Software Operational cuide - teen hes ‘Page a ae 


- “Preliminary Documentation bes ‘en Steed | ieee athin Wabalaer >, 


TABLE, OF CONTENTS continued) 


“anole HeGUIMENENTE kt ae Se ated 


oe. 


- ‘MEMORY. REQUIREMENTS | Oe ee a ee ee ree ee 


SOFTWARE, REQUIREMENTS ent Pole ere es 22 20) 
Master contro Program WP. Le ee ee eee ot 
"SY STEM/MAKEUSER Program Ba S lle ts, Geo ae “i. 8 ees uae? “2h 

abe! Contretter of raat, S05 ° ae te ee | 22 

SOFTWARE OPTIONS. 6 ee be ee a ie oe ee: ee 
Supervisory Message Control System (SHCS) s+ se | 23 

Application Progranss 00-0 se « ik ae ~ fs 

CANDE Prograa . se oe + eee ate ae oS. ee 

| FUNCTIONAL DESCRIPTION. ek ee en ee ee a ee 


STANDARD RJE ERNE A 5 boo eee eee eee: * 25 


FILE TRANSFERS e pee ae eek ese, we ee by te wees ce 26 


Maintaining Integrity, of ‘appara sce: _ 28 


VIRTUAL TERMINALS .. as 


Tersinal- -to-Progran, thiliMieations. 0. cay OF ee aig 29 
the user systen wae 2 2 3 rea ew es oe 8 32 
the server system se ee a Be AE eae ae a de -- eee a 
Remote Supervisory Console (RSC). se ee eee «34 
‘Prosraa- to- SY COM Comnun'tcations. ° 2 © «© © eis Ee ee 37 

-PROGRAM- To- PROGRAM nian ee piace mae . 38 

“NETWORK CONTREL we ee ee segs we eae ed oh os es . , 00 
Conversational Communications Procedure «:4 ° 2 e a mee. 

"Point-to-Point Contention Procedure» 2 see ee eee Oh 


Transmission cf Packed Cata Oe, aa, ee a Genet dares 45 he 


B1200/81700 SYSTEMS COMMUAICATIGNS MODULE 


Software Uperational Guide 
Preliminary Documentation 


TABLE OF CONTENTS Leon tinned) 


NETWORK CONTROLLER. 2 s. 2 0 ee ew ee we 


CONFIGURATIONS ANC SOFTWARE ASSOCIATIONS. 


Entry Level System. 2 © « «© «© «© 0 «© 2 @ 


Extended Level System 2. 2. « « « «© « « « 
ultimate Level System « « «© « «© «© «© « « 


MESSAGE PATH ASSIGNMENTS. «2 2 2 2 ee 


for the Entry Level Systeme + 2 se ee 


For the Extended Level System . ee . 


For the Uttimate Level System... . » 


QUEUE OEPTH CONTROL eo e©«© e * @ e @ - ® me | 


SYSTEM FILES. oo «© © e#® e© #® e® e© &® e© e@ e@ : ‘@ 


MASTER CONTROL PROGRAM MCP) FILES. = 2 
(SYSTEM) /USERCCODE File. @A “de a. ok, Fen ene 
NETWORK CONTRELLER FILES. «+. 2 eee 


Network Information CNIF) File. . a 


SYCOM FILES e 2 e e e ° e - ia ° e 7 e e 


Peripheral Files. . . » « so a4 ° 


Remote Files. e e , ° oo © e«© @® ee ® 


Queue Files 


t 
® 
® 
° 
e 
é 
8 
é 
6 
e 
8 
® 
e 


FESTRICTIONS. °° © «© © e@ : - ss» e© # oe @ oe e 


SECTION IIL 


COMMANDS 


a GENERAL . Gy “Seas a. a J e « “ a dn - °. | 


COMMANDS. . > » « 2 oom em oe * >. 8 e& a». 


12 Sep 1978 


Page - ma") 


(Original Version) | 


ee 43 
. 24 4h 
ee 44 
ae — «46 
eT: 
ee. 
ee 50 
ae + oe 
we S 55 
tee 5B 
be ents 59 
as 766 
44 59 
nua 60 
a 60 
tae be 
>: &s 6N 
bs. of 
Sos 62 
ee Ey 
os 65 


 exac0vei700 SYSTEMS. COMMUNICATIONS MOOULE 


Software Oper ational Guide 


Preliminary Documentation - 


“TABLE OF CONTENTS Ceontinued) 


12 Sep 97e ne 


Page a 


ot Oi ginal” veradony <->. 


i, daielis nie etieiaiaabl a, ath, wore 


Notation used in model format... .. 


Punctuation Rules... « oa:6 wae 2. 
Command Related Error Messages. . 2 ee 
CUES ek ODES Oe es 

Terminal Commands . . 6h oe ee a: 

GABOR Ts <"s: cee & eat a Sha ao oe 


oBYE. 2 0 oe ew we o °¢# — eoeeje ° a 


8 
t 
® 
Cd] 
® 
® 
. 
s 
® 
6 
t 
e 
® 
s 


» CONNECT. 


~COPY ee ee ae ee a ee ee ee ee 
SDISCONNEET. << 2:8 ose", @ ew ee wo 


APETCHe oe 00 ae cabs i a ele ae! 


“LIST oe <4 oe a ae 7“ 2 8 e ; e« °@ 


 @PUT. « oe @e e@ © 2 + 8 © e o 8 © « 
eUSER . . © 8 @ ‘2 on oe ee er ee ee 


WHAT 7 2¢ e ate oe bbaews * <s . 


*<SHCS Command stridg> (User system 


*2<SMCS/MCP Command String> (User System). 


“<x>< SMCS Command String> (Server system) 


ex 2eSHCS/NCP Scuenne String> (Server System). 


system ‘SPO/Frogran Coanands ° ia oe 


be aa: . ats : ae ee ee 


BIBON/B1700 SYSTEMS COMMUNICATIONS MODULE 12 Sep 1978 
Software Operationat Guide . 7 | Page ~ vil 
Preliminary Documentation | COriginat Verston)— 


TABLE OF CONTENTS (continued) 


System SPO/Program Commands (cont inued) 


Like SEAS he Cheah eee beeeee oF 
106s ose eh se eee ee See eee ee Oe 
LP Saeeee ee ewe tase teeneacie < * OF 
OR INE. 4g oe Gi ve ie: Sie, Giaay ae es ws oe ees 98 
MU oe cece tetceacastuceenwee. 99 


Br ee ee ea ee ee ee, 
Cans Ss oe Soe ec ee ORES ee eee | Aer 
eREAD © 2 ee ee ee eee ee ee ee ee ee we e102 
RN ee, ee WB aes SG Sie, ee A ee BS ee SS 
TSIGNOE: ie sai. ie, aw Ber Kn, Sw eee ee” AON 
SOP ee He ie Be. oe Sh oe ey we be te ws hee ete ee, OS 


Sea als wat ise. Gere ee com ae ey ee let) Sees See Se. ee, cee o e© e© « e e eo ee 8 106 


SECTION IV 
| OPERATING PROCEDURES 
INTRODUCTION. 2 2 eee ee ee ee te ee ee ee ee 109 
SYSTEM OPERATING PROCEDURES . . . . ss Bap. Ss os ee ee 109 
PRELIMINARY OPERATIONSe «6 6 ee ee ee ee ee we we 110 
Program Switches. . « Se ea ee _ aS Sue ee a 110 
Preparation of Parameters Card File - 2c 2 ee Lae e 400. 
Setup MCP peor an Naas Table. . .« - see ee : « . aarel 
Assigning Program Prioritiese . ae ares ° se or id, ca 422— 
EXECUTION GF SYCCM * WITHOUT SMCS . 6 2 ee ee eee .  4te 


EXECUTION OF SYCOM * WITH SMCS 2 6 7 ew eee ee ee TM 


-— gie00re1700° SYSTEMS, “COMMUNICATIONS MoD ULE Se ge sep nore: 


“Software Operational Guide i. aoe a Page = viii 


- Pretininary Documentation ae ee wees (Original Version) 


TABLE. OF CONTENTS Ccont inudd) 


wn nn nnn nn nn nn nnn nnn nnn nn bee nnn nen n nnn ene 


COMMON SYSTEF OPERATIONS) «2 se eee se me eRe ee m.. “Les, 


“suc: Signal Characterss ss . eee foe weary Tale, 


“Entering the Ca eo ee . 116 


“SYCOM Commands From ‘The SPO es ee Se te: Sa gt ee es ar, 


Systematic sycor Shutdown « 


“Reactionary Hints and Pointers. . . S, ( Hebden 8 oe eee) 127 
“TERMINAL PROCEDURES ent eee ee Tees a) 
TERMINAL FUNCTIONS. eb e ee Ls § beets Bats : | 
TERMINAL OPERATIONS csycou CONTROLLED). ee ee ae 

‘Example Interactive Terminal ‘Session. oo . ae es 
TERMINAL OPERATIONS COMES. CONTROLLED) ee ee ee 


7 Example Interactive Terminal Session. vie a 6 as oe 126 


“SECTION = 
GENERATING THE NETHORK CONTROLLERS 


GENERAL. . 2 4 -_ ee aad 


DETERMINING THE ‘SPECIFICATIONS. ee ree ee 
OPERATIONAL PROCEOURES. erie oe ee ee ee 
Preparation o f Input. « -- a ce te ee © | 
compilation Process ee Oe ee ee Rs * 
ONDE Compiler Modifications. ee % Gis ie ; 2 + 132 
Print ‘The USER /NCNIF File : ao Seb here oyee.e- Tes 
SAMPLE: ‘NOL “SOURCE FILE CLOC AL USER SYSTEW). 2 ee Ske et ABA 


SAMPLE. NOL SOURCE FILE CREMGTE SERVER SYSTEM) 2 


8 
@ 
8 
@ 
e 
e 
© 
Co 


B18GO/R1700 SYSTEMS CUMMUNICATIUNS MODULE 2 Sep 1978, 
Software Uperational Guide ; Page ~-. ix 
Preliminary Documentation | CGriginal Version) 


TABLE OF CONTENTS (continued) 


SECTION vI 
APPENDICES — 
APPENDIX Az ERROR MESSAGES «2 2 ee ee eee ee ee ee MO 


DESCRIPTION ® ® @e ® ® @ . s e eo ” ® ® e e ‘2 2 @ e ® d . . : | 142 


Command Error Messages. -e oc 8 6 8 8 ew iar fe oe oc. 143 
Command Infcrmational Messages. ° : See ode ee we 157 
System Parameter trror Messages « « « « -« one eae de ee 158 
System harning Messages « « 2. « = « « re , 166 
System Condition Messages Soy ae ee Sn Bk ee oe ek a 163. 
System Fatal Messages i : _— & de oe 166 


APPENDIX 8: CHARACTER SET. «ee ee ee eee ee ee ee 167 
APPENDIX Ci RESERVED WORDS .« gas . a ous eee HOE 
APPENDIX Dt COMMAND SUMMARY. 2 2 2 es ee we ee we ee 169 
APPENDIX E: COMMUNICATIONS CONTROL MESSAGES. « ss 2 eee 472 
CONE OW at we ete Ue es ws ee ee Be ee SS | 
SA TE ok WK 4 a oe we % GD gues A 


WESSAGE. FORMATS: & co cb o.0 ce: oe, 4) oy GW oP ee Shc me uc ete. “AF? 


Basic Data Communication Messages . . ° P a ae! 172 
SaheuGontrol tancase < : cos ee A a oe ts — se dae 173 
SPO Messages. .« a acre ° , oe ew ew a oe ee ee ee © ee 
Card Reader/Punch Message Sous er eh Oe ee A Gee, eS 174 
Line Printer Messagee « « « e ke oe ee a ee a . ° A174 
File Transfer Message Suis, wee Sea ee Ge ae ee oe os eel 
Virtual Terminal Messages « ss «ee oe ods er Sees 175 


File Separator Messages . i 


at e0avei700 SYSTEMS COMMUNICATIONS: MODULE ae gh 12, ‘Sep 1978 
Software Operational Guide eee Page ee re 


 Pretiminary Documentation 28 , ew Pe Se COriginal Version) 


TABLE 0 oF CONTENTS S Ceontinuéd) 


“Progra tom “Program Messages. os oe site oubara? as, 


Prograa- to- sYCOM ee ee 


APPENDIX F: RESTRICTED MCP COMMAND SUMMARY ee = aoe Sa aT 


Library Maintenance Instructions. - Se Se Soares See 

Program Control Instructions. ee sa wee oS Geren, Aer 

Program Control Instruction Attributes. = se. we Soe ee 478 
7 sy sten Control Instructions eee bee ts ib te Evie 178 


Job. spawning Control Attributes ase ue — o e 2 e A179 


APPENDIX Gt PARAMETERS FILE ATTRIBUTES»... eee eee) 180 | 


| Record Format eee ee ° bP a, aha oe ee 180° 
“APPENDIX HH? SUMMARY OF FILES. ae Btu te eos _ Bite acl 182 
paeeenre ee SAMPLE APPLICATION PROGRAMS. © + es se eee 183 
| | Program-to- Program (User System). Oe eee, as 5 ah _ 183 


-Program-to-Progran (Server System). « « « « oe a —_ 185) 


SECTION Vir 
GLOSSARY 
TERMS * . ss oe © S : te r o- : ‘ é se ie e ee ‘i | °° ; 7. > = @ e@° - 187. 


WORDNYNSS. 2 3 o8e bo OOS, 2 6 oOS we eed & ee Baris .7 202 


B1809/B1709 SYSTEMS COMMUNICATIONS MODULE 7 ae Sep 1978 
Software Operational Guide | Page - x1 
Preliminary Docunentat ion _ 7 (Grigtnal Verston) 


LIS?! OF [LLUSTRATIONS 


SECTION LI 


CONCEPTS AND FACILITIES 


Figure lI-1: User System Configuration oe a eS a SS =: ° 13 
Figure i1-2: Point-To-Point Switched Netwerk 2. 2 « « « « e 15 
Figure {I-2: Potnt-To-Point Non-switched cetderk x a a ae a 16 
Figure II74: User Syste - Server system Schematic ay ey sy oS 18 
Figure [1-5: Virtual Terminals Schematic ee 39 
Ficure II-6: RSC Input/Output Message Flow 2. « « « « P m a2? 85 
Figure lr-7: Program=to-SYCOH Schenae ie: 2 2 as bas 2 38 
Figure I!-8: Program=to-Program Schematic. o 6 « — o 8 39 
Figure [I79: User System Schematic . « « « © © « « «© © « « | 45. 
Figure [1-193 User System Schematic (terminals) 7 cc ee 47 


Figure II7il: User System Schematic (SMCSs terminals) 2. - .) 49° 


LIST OF ianctencee 


SECTION III 
COMMANDS 


— Table LII-1L: Command Input Summary . . 6 6 « aos. ge aoa : 107 


1800/8170 SYSTEMS: COMMUNICATIONS, MODULE 
“Software Operationat Guide | _ | vse Page = 


Preliminary Documentation 


ee eae ee 


HELE OEEEEEEES ESTE ELEEEE REET EE EEEEE SEES EDEEEDEEEEEEEEE EEE ESE EE EES 


ons tee ere re nee ee sce 


Do to the inforaatiéa: ‘avai 


REVISION HISTORY 


foo at bib sa ile ital aah itn om ae oe a0 a = a 


Griginal Release - Septeaber 1978 


“pocUNENTATION. NOTES. 


: hate leetetanadaieteteanekenie taeda tet b> 3 


faitable when this document was 


written» descriptions. Of functions and facilities for a 
remote host system. assumes a B1800/B17C0 series system. — 
When information becomes availtabte for. implementations 
of the Systems Commuications Module (SYCOM) on “other”. 
Burroughs systems» this Software Operational Guide witt — 
‘be updated to reftect those capability differences that — 


are peeves by B4800/B4700 and B680C/B6700 systems. 
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re a this document acorns the “Progr am-to-SYCOM™ 


and "Program-to-Program™ features» these capabilities 


are not yet implemented in this system release level. 
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The intent of this software operational guide is to enable its. 


user to successfully operate the Systems Ccamunicattons Module. 


CSYCOM) under control of the 61800/81700 Master Control Program 
(MCP). AS a means to this objectives this cocument defines scope 
and objectives, descrites inherent ana co#mend driven functionss — 
and presents basic implementation characteristics. Additttonally» 
provides operating procedures at both systea and terminal tevets. 
(Termiral operating procedures are limited to those capabilities 
within the scope of SYCOM.) | _— | 


The Systems Comaunications Module can he used ton a cuieitude of 
applications and by users with varying degrees of profictency tn — 
computer operations. Although thts guide has a tutorial stant » 
it does not claim to train cperators. fhe reader is assumed to 
have a tasic knowledge of the &1809/81799 system ana of the | 
Master Control Program (MCP). The reader is also assumed to be_ 
familiar with 81800/B81760 operating procedures» to have had | 
experience operating the system Supervisory Console (SPO) and | 
peripheral devices» and tc have a basic vocabulary of computer. 
related terms. The user need not however» need any knowledge of. 
programming or of the Network Definition Language (NOL). | 


This guide is designed to be self-containec. However» if the user 
wishes to have a deeper insight into the system's construction or — 
precise details as to the various tnternal system functions» a 

readinc of the "Network Definition Language keference Manual” and 


ens eons Software. Operational Guide” 1S strongly recommended. 
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Section t presents an overview. of the Systems Communications». 
Module along with the functions it performs. This section also 


identifies any dimitations which might be applicable to the - 
: pene ess oF ihe systen aid Aists associated docunent ations |, 


‘Section’ It jeceri bes concaptd. ‘ahd implementation characteristics: 
employed by the Systems Comitunications Module. This includes. 
system. configurationss functional specificationss— relationships 
in inter-system communicationss and intra-system relationships 
with other system software elements. Pictorial overviews are. 
| presented where applicable to elaborate points of interest. 
Presentation of the Functional Description progresses from basic 
introductions» to what 1s involved, thru detailed “how it works™ | 7 
ene eere | ck: Sie i ee a 


Section Lit descr ibes divdéttve éouuands sueitables to ‘che user | 
from either a Work Station (terminal) or the User SPO. With these | 
commands» the user directs. SYCOM to perfore specific. functions to. 

satisfy. a user®s. processing requirements. Examples are offered 

for each command which includes both commanc input and reply a. 
messages. The commands are presented in alphabetical order for 
ease of reference. The command language corstruction 1s presented 
in ag ihe ne Puan RG rey ate’ earoncsce semantics. | | 7 


Section tv contains ‘opera Ag propedurws for a SYCOM systen | 
Coperating independently 6f in. Conjunction with the Supervisory | 
Message Control System CSHES))- and for locat system terminals. 
Under the heading “System. Operating Procedures"» useful SYCOM | 
operating. procedures» commands» and operational hints/pointers 
are presented. Under the heading "Terminal Gperating Procedures» 
terminal operational commands and functions are covered which 
assume either a 10820 or TDB30. Video Display Terminat (VDT). 
Howevers, the system utilizes any Buen eae VOT: (see. 
"Limitations™). i 7 i «i : 


Section V presents instructions for the preparation of a Network 


Controller program required by the SYCOM system. It is basically 


comprised of a sample NDL coded input file for the Controtlerts _ 
generative process. Various comments are included throughout the 
sample Listing to explain variable parameter data which could be 
different for each installation. The procedure used to invoke | 
the generative precess for an operational Network Controller 
program tailored to the needs of individuat systems” is included. 
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Sectton V1 eonraine the appendices to this cocuments each of 
which is presented telow: 


Aprendix A provides lists of error messages and their meanings. 
These tists are broken down into two major categoriess those 
error messages which may oe disolayed in response to commands and 
those error messages which are displayed cn the User SPO which 
identify a processing exception condition within SYCOM. 


Appendix # contains the “character set" defined for terminal 
input/output and data transmissions. 


Appendix C lists the “reserved words” reccc¢nized by SYCOM either 
as a command or command option keyword. 


Appendix D contains a “command summary” which lists each command 
and briefly descrites its purpose. 


Appendix £ provides a list of all control messages used by the 
communications protocol and includes their assoctated format 
attributes. : 


Appendix F presents a list of restricted MCF commands which are 
permitted from a termiral or SPO on the User System. 


Appendix G descrites the PARAMETERS file attributes and details 
the parameters record format. 


Anopendix H provides a summary. of Se as files? including names 
and purposes. | | 


— Appendix I contains sample application procrams which show the 
mechanics of interfacing with SYCOM and the system's terminals 
for programetotprogram and terminal-to~orcgram communications. 
These sample programs can also be utilized in the system test. 


procedures once the appropriate Network Controtters are created 
cen the Systems installecd. 


Section VII is a glossary of terms and acronyms used throughout 
(this document. | | | 
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INTRODUCTION TO sYcoM 


GENERAL DESCRIPTICN 
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The rere Communications Module (SYCOM) program priouides the 
B1800/81700 user with 1) the capability to submit jobs to run on 
another — system» 2) to transfer files between two systems» and 3) 
in general» to interactivety obtain services and information from 
another system with the ability to communicate with interactive 
orocrams tn aremote system. Job run output can be returned to 
the submitting system Cupon request) or directed to a peripheral 
device on the processing system itself. Interactive outout data 
is returned to the User System directly» via Network Controllers. 


SYCOM along with its associated Network Controtiler is responsible 
for all data communications with other systems. This includes 
performing the necessary functions to establish Line connections» 
receive/transmit data» and execute the correct tine termination 
procedures. | | : 


The Systems Communications Module maintains. a secondary level of. 
control (MCP has primary control) over locat peripheral devices. 
such as the card readers card punch tine printer» and magnetic. 


tapes. It reads and transfers cards tape» and disk files» accepts | 


input froa. and displays messages to the Sucervisory Console (SPO) 
and receives data files/messaqes for printings punching» dtsolay» 
or.writing to either tape or disk. It orovices the mechanism by 
which a terminal or apolitcation program in cne system 15 able to 
communicate with specific application programs in another system. 
 Procram selection is based on the servicing system which. dictates 
the orocessina requirements Cprograms) optioned to run in that 

. System. | 
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The. purpose. of the. Systeus, Ebdbunications. vodule is to increase 
the use of data processing. facilities (systems). either tocal or. | 
remote to the target systems. The scope of SYCOM is to provide. pn 
alt.of those features previously afforded by the Remote Job Entry | 
CRJE/TERMINAL ) system and additionally provide enhancements with — 
the. following expansive communications features: file: transfers | 
terminal- to~programs program“to-program> and program=to-SYCOM. | 
The first two functions assime Inter-systean comaunications with 
the program- to-SYCOM function assuming intra-system communication 
which is provided by the MCPs The Systems Communications Module 
with these encompassing capabilities» considerabty expands the 
flexibility of a RJE Stations henceforth referred to as a "User 
ee ems | | | ae ak eee “i 


an addition to the above deSign objectives» several mandatory. 
objectives have been specified. They are: 1) Retain compatibility 
with the standard Burroughs | data communications line discipline 
and message format conventions. and 2) maintain standard Remote 
Job Entry CRJE) command cémpatibitity with existing RJE program 
products. for Burr ou gns:: oe medium» and large systems. 


With this eoeeuare system» ‘che abiectines’ are also to sencude the 
user with the most benefits in terms of flexibility and ease of 
use. Flexibility in that the user is free to design and install. 
system configurations suited to the requirements of the company. 
for distributed processings . For examples a user can install a. 
- B1800/B1700 in the same installation to increase/share resources 
with an existing systems. in. a remote instatlation to place some 
resources in a remote facility3. or in a network of systems to 
provide distributed. processing services. Fase of use in that all 
capabilities of the system can be selectively utilized by any | 
user thru. either command. initiated or inherent. system functions. 


| FUNCTIONS PERFORMED 


‘is “eae in ss “tapes < nua: tis ‘nites ss ae << ane wD GE Em -2a7 CE 
Se SO EE ER ee eae, ee eee eee ee 


Since SYCOM dapvrentiens: iaply transmission of large data fites 
betweer two or more systemse. line throughput maximizations error 
detections and error recovery are standard features. Following 
isa comprehensive. list of the functions per formed; including : 
those that are under user. control. They are presented in three 


groupsr Basic» Line CONN OUE: and Error eS a and Recovery. 
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BASIC FEATURES 


For SYCOM to accornlish the functions generally described for the 
System» the fottlowtng basic features are provideds ful! detarts 
are presenteo in Section II» "Concepts ano Facilities”. 


Ae Fite control: SYCOM verifies all file transfers between 
two systems. | , : | | - 


Be Input: Introduction of programs from an input device on 
the local system for compilation and/or execution on a 
remote system. Introduction of data from an input device 
on the tccal system for processing cn the remote system. 


C. Command Input: SYCOM commands as well as SMCS/MCP tyne 
commands are permitted from the system SPO» terminals» 
and specificattly tailored application programs running 
in that system. 


De Output: Dispersion of data and/or programs produced by. 
the remote system to the local systems perioheral output 
devicese SPO» terminals» and application programs. 


E. Monitoring: Monitoring and controttling programs on the 
remote system via a tocal system*s Remote Supervisory 
Console (RSC)s terminals SPO» or application program 
(requires SMCS on remote system). 


F. file Transters: The transfer of certain types of files 
between a local system and a remcte systems itn both 
dtrections. | : 


Ge Program-to~Program: Suoport of communicaticn between a | 

| program running tn a tocal system and a program running 
in a remote system. Also» support a ltocat application — 
program communications link to SYCCM itself. | 


H. Virtual Terminals: Provide a means by which a terminals 
SPU» or aoplication program in a lccal system can become 
a virtual terminal entity to a remcte system. By desitqns 
virtual terminals are automatically assigned the status 
of a Remote SPO when connected to a SMCS in the remote. 
system. 


Ie Communications: Supports a full tine of communications; 
asynchronous» synchronouse ana birary~synchronous data 
transmissions Cincluding broadband up to ood. COS). 
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javiwaestecn of rere throuakbut: is sseured by a point-to-point 


~ message, transfer procedure which: | 


Speciticality ackibWlédges receipt of a message with the 
transmission of either another message block or a 


*nuabered acknowledgement” (2ACK) message. This reduces — 
both line time and turnaround time. _ 


- Blocks records for . ‘transmissions (i.e.» sends multiple 


data records oo message block. 


Segaress ane expatid: peaks in data petomds It is coamon. 
for card input and printer output to have a Large number 


of tmbedded blanks... Eliminating transmission of these 
blanks: SU gnievcaue ey) improves line throughput . 


ERROR DETECTION AND RECOVERY 


The following features are. provided in error detection/recovery | 
areas to assure eee: Service to the. system user? | 


Ae 


rN specific nusbebed. ‘cheeuledaenent (either in the next 


message or in a HACK) guards against the possibility of 


a lost message by providing an unagsbiguous acknowledges. 


ment for the trahsmitted message block. 


The use of aoduis: 2 by ‘the transeission auaberiee 


; facility for the. detection of duplicate message blocks. 


Dynamic. reduction. Oby command) of the transeission 


message block size provides the potentival TOR reducing | 
(error tates and retransmissions. . | 


| The ‘Ouvention of different’ timeout wal dos: for iowst and — 


remote ee ee alleviate Line collision problems. 


. The message block beansiee peoceaine: A iminaces the | 


ambiguous use of certain ASCII controt characters. (for 


examples “ENQ" is used onty durino “establishment”; and 7 
no where euseue | a | . ars 


Data ChaneHission error deeeewren 1s provided thea the. 
use of vertical and horizontal paeety tn. the systems: 


_ hardware and software. 
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The Systems Communications Module CSYCOM) is intended to provide 
a combinea system of RJE» file transfers» orcoram-to-~SYCOM message 
transfer and termiral-to~program/program-to-program communication 
capabilities. Jo provide these services anc still maintain a 
certain degree cof compatibiiity with existing Remote Job Entry 
(RSE) systems» certain tinitations become inherent to the system. 
Therefores sep capne limitations are defired as follows: 


A. SYCOM does nots and Will not» support Cassette tapes as. 
an. optionat peripheral device. | es | 


Be. In reference to “file transfers”» the iuplewontation 
currently tn effect does not saves or forwards symbolic 
file headers. Therefores certain file characteristics 
would te lost on file transfers between unltixe systems. 


C. Program-*to-Program limitations involve an application 
program keing assigned a "virtual terminal” position 
which reduces the numter of poe etlGts available for. 
terminal attachments. 


D. Interactive application programs in a remote system 
serving virtual terminals on a tccal system cannot make 
use af “tallies” or "toggles". This prevents CANDE from 
from being a viable aoplication prcgram in this system. 


E. The implemented version of SYCOM which this document 
descrites» does not have the "file transfer recovery” 
capability. Therefore, when the cccasion arises when an 
inter-system connection is Lost» any in-process fite 
transfer operations are aborted ano must be restarted 
from the hegtinning. 


F. The most noticeable Limitation is the fact that SYCOM 
only supports a single tine connection for RJE and File 
Transfer cata communicationss at any one time. 


| NOTICE 


ie ae 1 aTp pee 
a em ot aemm mae wane 


The specifications of the software system described in this 
document are sutject to change without notice. The availability. 
or performance of some features may depend cn a specific | 
configuration of equipment such as larger memory or communication 

tine speed. Customers should consult their ‘Burroughs Sales 

“. Representative for details. 
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Some of the. ‘details of the: dystens Gosmunications: Module system. 


and its. composite software. elements are. cortained in other ate 


_ manuals. Following is a tist. of associated documents referenced © 
in this guide. Readers and. users of this document may refer to  — 


any, or att or ‘these | listed documents for additional information. 


- Company Confidential 


senna we seam temas 
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B1800/81700 SUPERVISORY MESSAGE CONTROL SYSTEM  PaS. 2219 0482 


‘MESSAGE CONTROL SYSTEM INTERFACE —. PS. 2212 5447 


B1700 NETWORK DEFINITION LANGUAGE BS. 2212 5223 
81800/81700 NOL LIBRARY art a  PaSs 2212 5215 


81700 DATA COMM AUDIT oe PS. 222 Sh2A 


Corporate Released 


Document Titte 3 eee ee ‘ey f ae Forn ues” 
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B1700 SYSTEM NETWORK DEF tAtTION LANGUAGE CNOL) =: 1073715 
REFERENCE MANUAL , a os 


ANFORMATION DARUAL « 


 BL700 SYSTEMS DATA COMMUNICATIONS a ee 1089992 


| BURROUGHS: CORPORATE DATA COMMUNICATIONS STAKDARDS 1284 9006 
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CONCEPTS AND FACILITIES 
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GENERAL DESCRIPTION | 
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Ts elaborate upon the desitn. concepts applied to SYCOM> ‘the. full 
range of system facilities are presented. in logical progression. _ 
First to be covered are actual system hardware configurations. 
‘This provides the base for further concept elaborations. Next» 
descriptions of the data communication networks involved and the | 
relationship. of a User System to a Server System are identified. 


Following this» implementation peomeeprs and functional aspects of: 
one system are described. | 7 | | 


THE SYSTEM CONFIGURATION tee 


A ‘User systen. oriented to. sycoM uEVeiees a Karduate configuration 
Similar to the one shown in Figure II-1 (next paged. A system is 
usually comprised of the. following hardware elements: processors 

memory» SPO» disk» plus standard communication control s/adapters. 
Optionatly it can be equipped with an assortment of peripherats 

a5 per aiuserts needs Ceeges Card reader» card punchs disk packs» 
ene printers magnetic tapes» etce and terminals). — 


The SYCOM program is ‘rempantinte for managing availability and 


use of peripherat devices which are used for SYCOM functions. It | 


also controls alt input/output operations for those peripheral 
devices as well as transmitting and receiving data files. (Data 
file is a generat term used here to encompass all file types 


_ acceptable to SYCOM such as datap program source/object» printer | 
_ backupe (OtCee) : | © ee Fs a 
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With this hardware configuration» "“all™ SYCOM capabilities for a | 
User System are initiated thru the system SFO. An “extended” User | 
System (configuration with local terminals) adds a new dimension 
to the sYCOM system in that it"s capabilities are ro longer 
contined to initiation from the SPO but are now atso available to 
local terminals as well. Commands entereo from a system SPO Can 
inttiate any SYCOM functions including establish the connection. 
for virtual terminal communications. Termirals ares however>s 
restricted to an explicit ccmmand repertoire. (Details of this 
concept are presented later in this section.) 


a a a i a i a i ee 


Terre cre res | ° ° Local 
‘ : ‘ ‘ Terminals . terminals 
° SPO e ° e ace an 
° ° meee eee ween optional 
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Figure II-1: User System Configuration 
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SYSTEM COMMUNICATIONS | 
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Oescki bad: here are ene: communications network aspects of a ‘User. 
Syste. and its relationship to a Server System. SYCOM and its . 
_ associated Network Controller Supports User Systems using either | 
a) point to~point. non= switched or point- to~point. switched network 
to a Server pee eae : | 


The ‘dake. Semnuniesurons prégédure utilized is a subst of ne 
Burroughs. conversational point-to-point line procedure. It . 
defined in a document entitled "Burroughs Corporate Data _ 
Communications Standards"; refer to “associated documentation". 
That document fully describes the characteristics and functional 


attributes for a non-transparent hatf-duplex mode of data 


communication to which this system subscribes. 


Point- tomPoint Switched Network at 


In a switched net work : Rata hia a User System communicates. 
with a Server System without requiring dedicated communication 
lines> see Figure II-2 (Con the following page). The computers 
are connected by telephone lines to the common carrier exchange 
serving their respective Locations. A temporary connection 
(data path) is established between the computers only for the 
period of time in which data transmission is actually. required. 
The connection is established by dialing the telephone number of 
the Server System. Usually the dialing procedure is manual» _ 
howevers SYCOM can cause this function to be done automaticatly 


upon command directive. 


In switched Line. networkss— a ‘Line refers to a discrete data nae 
between a Server System. and. ‘the User System Cincluding terminats) 
thru the common carrier exchange. The services provided by this. 
common carrier are usually on a time-used basis. — 1 & 4 
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Figure [1-2: Point-to-Point Switched Network 
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A point-te- ea tae: ionsawitohid. ‘Ratwork> as shown in Figure l- 3 | 
(below)» consists of a private or leased communications Line cha 
connects the User System with a Server Systems In this network» 
the. computers are physically €onnected> that is» the circuits 
making up the communications line are permanently establisheds 


and data may be transmitted. over the line at any. time. No Laren tes oe F 


3s) required. for this type. of network. 


Communication tines in a ford@euitched network are atieriatery: 


known as privates teased» or dedicated Lines. In this. document 


they are referred to as “dedicated lines". These lines may be. 
privately owned (e.ge» internat direct connection in the same | 


. physicai location)» or provided by a comm@on carrier on a contract 


pasise This dedicated connection between two ee Locations 
would provide a tine for exclusive system. USC. 


om enna an anaean « J onmnan| nae an ee Co ae ee on a we oe am 
f---1 D/S I[-<---- ee ee ee ae ee (ce 
{ 81800 or 81700 it = |Ierrr-!] / i-----{ %§ 81800 or B1700 1 

_— | wemmmnt DS tmmsto 

i User System 1! ee es ea poencon| i Server System t | 
{ = 7 | d proses 3 | | ie _ a . 
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Note: Direct | \ 
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Communications Procedure 


Kith the conversational point-to-point communications procedure 
assumed by SYCOM» inherent provisions incluae the capability to 
“reverse” message block transmissions without having to tnvoke 
separate establishment and termination procedures. The essential 
characteristic of this capability is its ability to specifically 
“acknowledge” receipt of the previous message block. This its 
accomplished by including a sveciat acknowledgement character in 
the header of the “next™ message block transmitted. This special 
Character is the Acknowledge Received Message (ARM) character. | 


The usefulness of the ARM character is twofold: First» it 
provides a specific acknowledgement to the receipt of a previous 
message block by utilizing the “numbered ACK" facility. Secondlys 
when the receiving system receives a message block that it cannot 
accept (no buffer space or a svecific peripheral is not-ready)>» 
the AKM character permits an implicit NAK of that message block. 
This is achieved by. transmitting the NAK ir the next outgoing 

Be Ssag © block. a 


User System - Server System Relationshtio 
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The concept of a User System - Server Syne: relationship is 
quite fleeting» especially when both systems are in the same | 
physical location. The important ooint to rememters however» is 
the basic principles of this relationship (des scribed below) and 
ho w it spenee to this system. | 


Referring to Figure 1174 Cfollowing page)s»s the User System is 
viewed as the system in the network which serves as a point of 

data coltection and data distribution. For examples RJE type card 
inputs card outputs line printer output» ard/or terminal input/ 
output messageSe f 4 | 3 Keg 7 


A Server System on the other hand is generally considered to be 


the data processing systems often referred to as a Host System or 


Central System. It normally receives targe volumes of data from 
a User System to be processed or prograa scurce files to be 
compiled. In the case of program compilations» the printout and/ 
or program object code files can be transmitted tack to the User 
System (upon request) for printing or possible program execution. 


Interactive output is returned directly to the initiating program 


or terminal via the Network Controllers. 


Software: ‘Operational Guide 
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The actual physical size of a computer howevers has relatively 

tittle importance when considering a system as a Server System. 
The B18C0/81700 system can be either a User or Server Systems | 

depending on the angte of view and the services required at the 
time. It can alsa bes under certain circunstancess both a User 
system and a Server system. | | 


SY COM AND ITS EAVIRGNMENT 
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The fottowing list of equipment must be oresent for SYCOM system 
operations. However» the listed equipment is not dedicated to. 
SYCGM Cor supporting system software) and is available for use by 
other programs. _* *e | 


Hardware Type : | , | 7 Usage 


B1800/81700 Central Processor System Control. 
98 KB Main Memory (minimum) System Software 
Secondary Memory (disk: storage) Program/Data Files 


Cheadtper-tracks pack) 


120 or 132 Position Printer | | Line orinter out put 
89 or 96 Column Cara Reader : control /RJE Type amine: 
&Q0 or 96 Column Card Punch Controt/KJE Type Output 
~ System spo | | — MCP/SYCCM/SMCS Oper ations 
Single or Multi Line Control. —System/Terminat Communications 
Line Adapters as Requared | System/Terminal Communications 


C(leased» switched» direct) 


Data Sets and Cables. | ) System/Terminal Communications 
(as required) | | | 


T0620/T0850 Terminals | As Required 
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Provided here ts a ee of ‘Bystee Per raree e\enants and Aheres 
associated memcry requiresents. They can be used to approximate 
memory. requirements for an interactive 81890/817090 SYCOM systems 
operating With or. without) a Supervisory Message Control System 
CSMCS)= | = | 7 iy | 
= 64.0 KB Master Control Prograe (MCP). 
— 15.0 KB Network Controller (basic). 
- 3.9 KB Each additionat Line in the controller. 
- 16.0 KB supervisory Message controt system (SNCS). 
= 18.0 KB Systems: Communications Module csyeom. 
- 22.0 KB ‘Comand AND Edit syster (CANDE D6 
- 2.0 Ke Each additionat terminal logged-on. CANDE. 


After deteraining bie basis: Geeeey requirements ion. the systems 


additional memory must be inctuded for any other programs that 
are to be executed in conjunction with SYCOM. (See appropriate 
3 reference. wanuals for those memory: ceguseemens estimates. »— 


SOF TWARE REQUERERENES. * 


mo oh 7 ww on m ~™ on a eee ere ene oe 


tn order for SYCOM to ‘beatae ‘Bperationals certain system software 
elements are required. Although these elements support the 
operation of SYCOM> they ara. general purpose and in fact support. 
the entire system. Each software element icentified here is 
individualty documented for its capabilities and requirements. — 
 Fotlowing is the List of those pertinent system software elesents 
She C eee to eupoeEt SYCOM peng yous: | : | es 


. Master Control Progras (MCP) 
. "SY STEM/MAKEUSER program | 
. DMPALL program 


_« Network Controller program 
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Master Control Program (MCP) 


The MCP ts an aperatine System which manages the. demands and 
resources of f1LE00/B170G systens. It reduces programming eres 
by providing a family of commonly needed furctions and services. — 
The MCP requires strict user adherence to crogram structures and 
procedures in order that there may be com@unication between the 

different programs» interpreters» and the vMCP itself. | 


Its primary function is to optimize the procuctivity of a system. 
External intervention is hetd to a minimutse and maximum through- 
put is achieved by incorporating into the wWCP the primary tasks | 
of Input/Output (I/G) controls file nandlirg» anultiorocessings | 
interruptse memcry allocation» application proarams» and operator 
interfaces. | | 


SYSTEM/MAKEUSER Program 


A utility program that is used to creates modify» and access the 
system's “usercode”™ file. This file contains atl valid system — 
usercode/password combinations. These usercodescpasswords are 
maintained in a file named “CSYSTEM)/JUSERCCCE"™. With this file>» 
the MCP can supports and enforces a file security mechanism for | 
disk files and programs/users that access them. | 


OMPALL Program 


The OMPALL program is a general media conversion facility that 
allows reproduction of files from one medium to another. It also 
can List files from any medium with bytes digits or combined 

format. Along with these abilities it can start or stop its. 


reading of these files at a specified record. Specifications for | 


these functions may he passed to DMPALL fron a SPQ» Card Reader >» 
or tocal System terminal. 
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“Network | Controtter. 


thie Network Controtter. is a. ietuor’ Definition Language. CNDL) i 
type. program whose prime function is to process and supervise. the 
flow of messages between systems» terminals» and programs. It | 
performs all data communication tine. discipline functions which 
are necessary for proper Line/terminal control. The Network 
Controttier handtes the initiation and completion of ‘comaunication 
I/O0*s and services exception. conditions. In order to optimatly. 
provide these functions» the Network Controlter is configured» bY 
NDL generation» to the specific needs of the system on which it. 
is to be runs Ci.se.» the number and type Lines» number and type | 
terminals» etc.).- A product. of this generative process is the — 
Network Information File (NIF). This file contains ait terminal 
and communication line attributes as well as hegne at aspects. of 
the communicaticns networks — 


es4 ically: this Centroller enables. messages to pass between it 
and SYCUN as well as other terminal oriented programs executing 
tn the systems. This is accoaplished via MCP supported Remote 
Files and Gueuets: along with the Controtler’ S$ message switching. 
capability. Each program that is to be part of the message flow 
Must contain a "remote file™ for input/output message traffic and. 


it must be known to the Network Controller; this includes SYCOM. 


SOFTWARE OPTIONS 


The following software eié its. are not required but may be used 
tn convanctyed MVen SYCOM to ‘service a particular user's needs. 


ai, Supervisory Kessage Controt System CSHCS) _ 
ro Application Prograas 


“ae CANDE Progras (aultiple-user text editing) 


Ni thedoh the super va ORD Message Controt euptea. is not a penateed: 
system software element for the operation of a SYCOM system» it — 
¥s definitely suggested for those systems which have. terminals. A> 
Terasinat in a SYCO™M systema environment is permitted to initiate 
"file transfers" or become a “virtual terminal" entity on a_ : 
Server System. Additionally,» these terminals may be utitized for. 


other. applications such as data entry and program development. To 
 faintain overall control of the terminals in these varied system 


 environmentse the SMCS Decoaes the Hegnereltina ae laneee a 
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Supervisory Message Control System (SMCS) 


The Supervisory Message Control System (SMCS) 1s tntended to be 
the “supervisor” for a data communications software system which 
includes such Burroughs software elements as "SYCGM"» CANDEs and 
other online programs of either Burroughs or customer arigin. 


The SMCS provides to an interactive system» many functions and 
special features. Toa fully exptore its capabilities» please 
consult the "SMCS Software Operational Guide”. Howevers the 
highliqhts of some of the more pnertinent functions are presented 
here. Felevant tc the SYCOM svstem» S¥CS provides some basic 
message switching (terminal to terminals» terminal to SPO» and SPO 
to terminal)» attachment of terminals to application programs via 
a remote file» and information about the system's network. 


Additionally» it controls terminal log-on security (checkine of. 
user security codes and granting access to user files) and 
approves Cor dentes) alt remote file opens to terminals under its 
control. Moreover» SMCS provides a certain degree of resource 
allocation. By this is meant» thru security» job controls remote 
file controls and error handling» the SMCS can allocate some of 
the systems resources. For example» for every terminal controtled 
by the SMCS» it has firal control over that device as a resource. 
It can therefore» temporarily "attach" terminats to SYCOM ty | 
re ans of the SMCS “SIGN ON" facility. 


Application Procrams 


Effectively there are three types of application programs useful 
to the SYCOM system user» they are: 1) Interactive data entry» 

2) system~to*syster» and 3) command input tc SYCOM. Each prograa 
type is briefly described here with details of how they actually 
work presented in the following “Functional Description". | 


A user can elect to develop an “*interactive®™ appticatton progran 
tailored to specific needs of an installaticn. These specific 
needs could inctude such applicationat functions as data entry. 
infurmation retrieval» or any anoplication cesired. 


If there 1s a requirement for an application program in a User. 
System to communicate directly with another application orogram 
in a Server Systenr the capability is there. This communication 
tink is directly thru the Network Controllers and SYCOM-has no 


role in this message traffic. sycam does however> initially. 
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approve a "virtual terminal. ten. fie: ddentiticativa. ond control 


purposes. This is a residual. capability based on Fequirosents 


for ‘Network Controllers ay sYcoM. 


The ‘nied —P ot applicatiéd program Deovices. gia. source for. a 


string. of SYCOM commands to be performed on an automatic basis. | 


Normally. this would be for. off- hours operation but could also be 
utilized: for” common everyday, occurrences of a work flow ‘pattern. 


sca 


She BL800/B1700. CANDE aeoersa: seuvides generatited file apdeeiag 
and preparation capabilities in an interactives terminat oriented | 


environment. CANDE performs these file updating and text editing — 


functions in program development. and other such environments. For 
this system however» CANDE can only be utilized when SYCOM is not — 
involved Cte, Or the creation and maintenance | of "NOL source” | 
Spies a 7 ee | 


The CANDE aystes has been. Le to run ina self- sustaining | 
operation. or in conjunction with the SMCS. Cin etther case» it. 
requires a Network Controller for data cossunication functions.) 
It operates with a basic usercode~password. type of security that 
; is available to CANDE> and Shoo from the MCP. 


“FUNCTIONAL DESCRIPTION. 


<< om ae seer I one  aliisecadtvomlitassandtinapnatbermaleaundlle snalitanndtsc sedivanndtt aanediiesaudtinecditnanaditins oud 
on SO EL SS OS LE AN LG SE AS AE OY AE nO, ME, CANE | 


The ante aa SYCOM. is dépendent upon support from a Network 
Controtler program. This Network Controtler provides interfacing 
links between SYCOM and the: communications hardware (terminals — 
and other Systems). The controtter furnishes those services and 
Capabilities which are outlined in generat with the preceding | 
subjects» “Software Requirements". Throughout this descriptions. 
Network Controtter functions are elaborated upon where it is 
necessary to maintain continuity of subject matter. Concluding — 
this sections the functions of a Network Controtter is outlined 
under the heading "Network Controlier” Se ee 


The fe iteuing 4 eatucee: of ‘the evetee are funetionatay desceihea 
in the order in which they are identified below: Standard RJE» 
File transfers» Virtual terminals» Prograg-to~program»s and | 7 

 . Network control. The virtual terminal capability contributes — 
—  terminat-to~programs. program-to~SYCONs ang ‘Remote. So a eee 


_ Console CRSC) congunications. 
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STANDARD RJE FUNCTIONS 


The SYCOM program controls» at a secondary level» alt typical RJE 
peripheral devices of a User System. It reads and punches cards» 
Prints outputs accepts SPO inputs» displays SPO output messagesp 
and transfers file/control messages between the User system and a 
server ers | 


Input can be directly from a card readers from tane or disk thru 
file equates» or from the SPO. Card reader input is generatly 
associated with RJF batch data transmissicnss whereas magnetic 
tape and disk input more directly relates to file transfers. 
Howevere these operations tn SYCOM are corsidered synonymous. 


Commands can be alternately input from a specifically designed 
application procram thru the *Program-to-SYCOm" facility. With 
this mechanisms the RJE inoput as well as associated output could. 
ce automatically controlted ona daily basis without requiring. 
the system operator to enter a long series of commands to SYCOM. 


QCutput can be made directly to a card punchs Line printers disk» 
magnetic tape» or SPO. However» in the case of a printer or card 
punch» the data received can te in the form of a “tackup file" 
which is first written to disk. Subsequent MCP commands are 
entered to cause printing or punchina as approoriate. 


Furthermores SYCUHM gives certain directives to the Network 
Controlter such as requesting it to establish or revrestablish a 
connection to a Server Systeme SYCOM alse causes the controller 
to enter an “idle™ state while waiting for an incoming connection 
to be established and to terminate a connection when appropriate. — 


The transmission of RJE data files to/from a Server System occurs 
as follows: A user of the User System prepares a card deck for 7 
transmission to the Server System. The cards are read» compressed 
and blocked by SYCOM Cupen command ) and written into the bene ena 
Controller's rercte file. (See writeup on “Queue Depth Control", 
The controtler beains immediately to transmit these card images 
(message hlocks) to the Server System. This process continues 
until alt cards have been read and transmitted. The card file, 


KNOWN as a. rjiob stream" is then under controt of the Server 


System's MCP which processes that job streag as per directives 
included in that file (compile and/or execute). | 
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att SPO type messages when pertain to ‘chat. job (Bou. EOS> and: so 
SPC messages) are transmitted back to the User System for disptay | 


on the User SPO. Messages can be entered via the SPO to control. ee 


_ jobs executing on the Server System or manipulate data files as 
- required; providing a MCS is running in that system. SYCOM ae 

accepts these messages and writes them to the Network Controller 
for transaission to the Server Systen and aupecquens processing... . 


when. the. job. “hes pinicheds: ‘day: Teseen ited Vine printer ‘and card 

punch output created at the Server System is transmitted back to. 

the User System. (This is. dependent. upon the software system in 

the Server System? HOST/RJE does this automatically where SYCOM. 

. does not.) The Network Controller receives these incoming message 

— blocks and forwards them to SYCOM via SYCCM's remote file Cinout 
queue). SYCOM then appropriately prints and/or bunches: this data 
on a User Systes poniengee. eid acl | 


The afore daseribes process. de cites the flow Be: data ‘Between es 
the User System and a Server Systems often referred to as a "job 
stream". Any nuaber of job. streams may be initiated at the same. 
time Cmuitipte server System. MCP directives contained in one. job_ 
file) from a User System. The number of jobs which can or will 
run on a Server System is limited erty to its Capabiiy 19s: to 


| DESCEss thea. 


FILE TRANSFERS 


: , 
en OE OO OS a SD 8 


bee both disk ane magnetic tape | 
devices. Files may be transferred between any combination of — 
_ these devices. Magnetic tape. transfers are restricted howevers. 
in that onty one file oer. tape. may be transferred. Library. tapes 
created by the "LGAD.DUMP™. function are not supported by SYCOM. — 
(These tape files are first Loaded to disk and then transferred.) | 
Between “unlike” systems» only program code files and 8-bit data. 
files Cincludes text files) are permitted. On the other hands — 
"Like™ systems can transfer other files such as printer backups | 
punch. backup» interpreters. intrinsic» and dump. files. The data 
communications crotocol allows transfer ou, se one file at a “ee 
times in each direction. 


File epaneters: are ‘suppavtid 1 


The user aitie Cee. a file Seanctar ve enterine: a. copy" coneand a 
to SYCOmM (PUT and FETCH. are acceptable alternates). The command | 

syntax allows source and cestination systems. to be. specified an - 
(PUT and FETCH exctuded) for the transfer via attributes. These. | 
- source and destination system identifiers. must be the same as | 


these. specified in the “"system~ va" Eenenor. wessage at connection: 


— initialization. time. 
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If the specified scurce. system is the User Systeme the transfer 
is a “PUT"> which is a transfer of a file "to" another system and 
is based on SYCOM*s “SYSTEMID™ parameter. hhen the source system 
is a Server Systeme then the transfer is a "FETCH"? which is the 
transfer of a file “from” another systems also based on SYCOM'S 
"SYSTEMIO”™ parameter. | a | 


The actual transfer of a file is initiated ty exchange of control 
information tetween systemss this process is often referred to as 
"handshaking™. AL file transfers occur as “Put's”. That is» if 
one system wishes to do a “"Fetch"s» it sends a “Fetch message” to 
the other system. This causes the cther system to inttiate a. 
"Put”™ sequence ty sending a “Put Message” to the initiating 
System. Put and Fetch messages completely specify both source 
and destination file attributes. The Put message elicits a "Put 
Reply Message™»s signifying that data transfer may tegin. The 
sender system then sends one or more data message blocks which | 
are eventually followed by an end-of-file message. 


Upon completion of the file transfer» the system that received 
the file tnforms the originating system of the completion. This 
notification is made with a “user destined control message". 


If either systew wishes to abort an in-process file transfer (for 
any reason)» that system sends either an “Abort Put” or “Abort 
Fetch" system control message to the other system. An abort is _ 
initiated hy the approoriate command entered to SYCOM. Alternate 
"device not readys suspend” and “device reacys resume™ messages 
are used for flow control at any time for temporary stoppages. 


A file transfer request that cannot be processed when entered» 
because another file transfer is tn orogress» is queued to disk 
and processed when next possible. Although there is a maximum 
depth to this disk queue (see “Restrictions")» it is sufficient 
to handle alt but the most extreme cases. This feature prevents 
request rejecticns due to the fact that only one file transfer. 
Cin each direction) can be in-process at any given time. Requests 
are queued on a first comes first serves basis. This mechanism 
assures an orderly processing sequence. | 7 | 


AN imPortant point to notes» all file transfer requests are queued 
as "Puts". This is» if a user requests a data file “Fetch”, that 
request is sent ta the other system's syccr where it is queued as 
a "Put" on that system. 7 a | | | 
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deineatning Tat eqntty of Fila CRapaciers ties 


a leaeaaatea acta eee ta ttete eta tate te etetateteheastatetatateatatetatetetakatatee 


ok goat of. the ‘Cite. canter ‘ebehanise is to ‘maintain as. many ot: ‘a 
file's characteristics as possible throughcut the transfer. for 

| examples if a COBCL source program is transferred» it should be 
capable of being compiled» Without further nodifications on the 
receiving system. Likewises. if a prograa code file is transferred 
to a *like system"™> it should be executable without modi fication. 


Specifically» if a file is thadsterred between two Like ary ee 
even if via one or more unlike systems» all file characteristics 
must be preserved. To accomplish thise a symbolic version of the 
file's header Cunderstandable to att systems) is transferred with 
the fite. This symbolic file header is the “PUT-OR-FETCH- RECORD*™ 
as defined for SYCOM file. transfers. It 15 prefixed in the data 
stream oy a Rags ON EnI TOs, ‘header control message. : 


ih the receiving eyeieds when. a webGtae fite Noaage is eaccived: 
as many as possible of the tile characteristics are incorporated | 
into the file being created/received. If the file is transferred 

to an "unlike® system» the symbolic file header and the original | 
systen type are saved with the file» to be forwarded with the | 


file whenever it is again transferred. If the. file is transferred at 
to its original system types the entire symbolic file header is 


- gncorporated to create a file identical itn characteristics to the 


: gota iter: and the sysbolic header is not Saved. 2 ae 


“When a system wena: one +e TT? oun Aieee it aust aaetude in the 
symbolic file headers enough information for it to recreate that 
file if returned. If this file is returned» it must be made to. 
look identicat to the original file, With the exception of "file 
name™ (this is conveyed in the symbolic file header). | 


an unlike system. enacted. file may be changed or pencaced Locally» 
thus invalidating the saved symbolic file header. In this cases 
the symbolic file header describes the file according to its new 
creation euae® type. 


NOTE OF IMPORTANCE: The *“syabolic. file headers discussed anave 7 
‘is not implemented in this version of the system software. It 
will however» be available in a later release of the system. - 
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VIRTUAL TERMINALS 


To the SYCOM system» a “virtual terminal" can be either a locat 
terminals the system SPN» or an application program. Therefore, 
virtual terminats 15 a togtcal capability whereby a message path 
can be establishea between a terminal» SPGr or program on the 
User System and an appropriate interactive application program 

in a Server System. Additionally» utilize the tnherent capability 
of controlling jobs in a Server System witht a speciat MCP command 
repertotre. Basicatly» on the Server Systen end» this becomes a 
reality thru the capabilities of the SMCS. Howeveres the main 
-inter-system connections are established ty SYCUM which makes it 
possitte. Refer to Figure [1-5 for a pictoriat overview of a 
User System with virtual terminals. (CInteractive application 
programs can be any program using a “remote file” but not using 
"tallies" or “toggles™.) | 


The terminals are virtual in that all User System facilities as. 
wetl as all Server System facilities are available to the system 
user. User System commands are local and are therefore» processed 
within the User System by either SYCOM» SMCS» MCP» or application. 
program. Server System input messages are accepted by the User _ 
System and transmitted to the Server System (via the Network 
Controlters) for processing and subsequent reply messages. — 


In view of a "virtual terminal" in an interactive environments. 
Server System commands must be forwarded as soon as possible. To 
effect this requirement» SYCOM has the capability to "interleave® 
a “user destined control message™ into the cata transmission 
stream tmneditately if a file transfer ts in progress. If SYCO™ 
1s not presently transmitting a file» the control message which 
contains the virtual terminal message is Iewediately transmitted 
on an individual basis to the Server System. 


Lil le a ice alta polcbe nado al 


Wnen SYCOM ts utilized in a larger systen Heveltoonsnt or data 
entry environment (with terminals)» then the User System og enen 
in Figure II-11 is applicable. In that hardware/software 
configurations the complete spectrum of SYCOM capabilities are 
available to the system user. To be more specificr in addition. 
to the capabilities previously identified» a terminal-to-program 
capability is available to the terminal user. 
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In this environments SYCOM still communicates directly with the 
Network Controller for normal communications activity. However, 
the SMCS maintains elementary control over SYCOM and control over 
a system's terminals. To clarity this» the SMCS directly causes 
the execution of SYCOM when a terminal Cor &SC) “sigqns-on™ to 
SYCOM thru the SMCS. A terminal user can then direct commands to 
SYCGM in the User Systew oar the SMCS in either the User or Server. 
System. Exactly which commands and how the directives are given 
is covered tn Section [V» “Terminal Operaticns”™. An important 
notes these capabilities are also available to the user who 
optionatiy elects not to utilize a SMCS in the system. (Refer to 
Figures II-9 and If-10 for configuration cverviews.) | | 


With the introduction of the SMCS software element into a system» 
all of its commandse functions» and capabilities become available 
to the terminal user. (Refer to the "SMCS Software Operational 
Guide™ for goede and capabilities. ) 


Before proceedings it might be helpful to this discussion for the 
terms User System and Server System to again te clarified. A User 
System is the comnuter on which there are terminals/users wishing 
to engage in interactive computing sessions. The Server System is 
the computer that suopltes those interactive services ona demand 
basis. (Refer to SaQUes I1-45 back a hit.) 


The communications protocot assumed by SYCOM supports User System 
terminals connected (logically) to an interactive application 
pragram on a Server System. Using this protocol minimizes the 
vistbility of interfacing software elements so that to a users it 
appears as though the terminal is connected directly to the 
application program. The terminal is then used as 1f tt was 


locally attached to that orogram (see "Message Path Assignments” 
turther on in this section). . 


Presently available interactive application programs may ke used 
or the user can optionally elect to develoo a special application 
program for Perens and/or other program interaction. 


The method for conveying terminal data between two systems makes 
use of the “device address” field tn the control message. This 
message specifies the terminal with which the message text is 
associated. The device address in the cortext is termed "virtual 
address™» and is the name used by both User and Server Systems to 
reference a particular terminal. This addressina scheme follows: 


A. The device address is comprised of two characters; one 
upper. case and ore lower case at enevelre letter. 
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Be The User System “transmits” a virtual terminal address 
as lower case/upper case letters. When it “receives” a 
response message from the Server Systems. the terminal - 
address tetters are ‘reversed; upper case/lower case. 


Be oe “The. Server Sy stea MPddeives® a virtual. terminal message 
with a device address of lower/upper case letters Cas 
transmitted by the User System). The virtual terminat 
addressing scheme. then requires the Server System to 
-"reverse™ these device address characters prior to its. 
transmission back to. the User Systea. (These transmits 
receive device addresses are specified in the Network | 
Controller's NOL generation process» pene aye eee 


- De Assume. that a User. Systen supports a connection for Vive. 
i .terminats to a Server System. The User System refers to 
these: terminals by virtual terminal (transmit) address:- 


ahs bay chy dhe and eA 


The Server syetew ae gorens to these same Pecwin (a by 
virtual terminal (transmit) addresss but» as the Server 
- Systems role is reversed» its transmit address is atso 

reversed. For exaapte: 


Aas Ab» Ace Ady and Ae 


The oi lewing: events represent the terminal-to- program procedure 
implemented by SYCOM. These events portray an interactive session — 
between a virtual | terminal. On a User Sy Shee and an A Le | 
(proces ona server Systems - | 


the user system 


At initialization time» Sycom issues a “remote file inforaat ton™ 
request to obtains from the Network Controllers the Logical 
Station Numbers (lisn's) for the virtual terminals assigned to the 
system. These numbers are placed into a table which maps the | 
actual "lsn" of each virtual terminal into a virtual "tsa" with. 
which ‘Ssycam can Earecence the Ceeresr enn: virtual terminal. — 


When so snr tedieet & sivedbten ten a a ee 
command is entered to the User System’s SYCCM.. SYCOM finds the | 


"next" available entry in its “virtual tsn table" and transmits a 


"connect message” to the specified Server System. This control. 
message contains a virtual terminal address. Upon receipt. of the 
"connect reply message» ~—SYCOM replies with the pestle: | 
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During the life of a connection» allt data messages entered from a 
virtual terminal are sent to the Server System for processing. 
(Excluded are any tocal SMCS commands which are prefixed with the 
assigned signal character.) This is accoanlished by doing a 
remote file write to the Controller using the terminat's virtual 
terminal “*tsn". [n processing this messages the Controller maps 
the virtual terminal isn into the assigned virtual terminal | 
address (two characters). The message is then transmitted to the 
Server System» according to SYCOM protocols with the virtual _ 
terminal address. The terminal user can then “sign on™ to any 
application program that its supported in the Server System, 
providing the cavability is inherent in the form of a “CS.” 


Any incoming message to the Network Contrctter from a SYCOM line 
which contains a virtual terminal address (Céeger» *Aa™» “Ab"» etc) 
is sent to SYCOM. These messages are written into SYCOM'’s remote 
file LINK) by the Controtler with a device address aporocriate 
for the terminal. SYCOM uvnon reading the messages searches the. 
virtual terminat address table for the actual system "lsn"™ for. 
that terminal. SYCOM then puts the actual "tsn" into the reply. 
message and writes it into the Network Controller's remote file 
(station queue) for distribution to the originating terminal. 


In the case where the virtual terminal is actuatly an application 
programe the reply message is sent to that program via the queue | 
mechanism for "program=to~SYCOM™ communications. 


When the user wishes to disconnect from the Server Systems a | 
*".,DISCONNECT™ command its entered to tocatl SYCOM which transmits a 
"disconnect message” to the Server Systems specifying the virtual 
terminal address to te disconnected. The terminal 1s notified of 
this action and is then free to establish another connection or 
work pattern as desired. (Virtual terminals are automatically 
disconnected when the system operator enters the ".£0J" command.) 


the server system 


The Server System's Network Controller intercepts “connect™ and 
"“disconnect™ messages Cuntike all other cortrot message which are. 
routed to SYCGM). Gn receift of a “connect message"» the Network 
Controller verifies that the addressed virtual terminal exists. 
checks to see it it can support another ceornections and that some 
interactive application program is ready to accept input from it. 
If alt is okay» the Network Controller returns a “connect reply 
message” indicating successful comoletions else the Controttler | 
sends back an error response tn a “connect reply message". 
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If. the connection is euecesstuls the Server System jaree this. 
virtual terminal aopear as a terminal Local to “nee system Cue 


not vee “signad- on"). 


During the life of the connections any TTT data reeeived by the: 


Server System's Network Controttler for an enabled virtual — 


terminal is conveyed to the Waiting application program thru its. 
remote file (could be the ‘SHCS). This messace transfer eGe nen nee 
in exactly the same manner as for local terminals. Any output 
data generated by the Network Controtter is transmitted to the 
User enon with oue virtual terminal address Bpcen ses. | 


The Server Syeten upon cedeipt of a "disconnect ossagee: takes | 


necessary action to detach that virtual terminal and respond to. 
the User RSLS eM an ap eeerracs mOVSCeONeee reply aotpecere 


Remote Supervisory. Console Rse 


7 an 08 we a mn aD ee oe oe oe ecm ween ns asiwan 


It. as an inherent capability. of the egeteu to utilize the SP Or 
application programs» or a términat in a User System as a eae. 
Spot. to a Server System. This only occurs whens as Figure II-6 
shows» a copy of the SMCS is running in the Server System. for — 
this system» the SPO is also referred to as a “Remote Supervisory 
Consoles or siaply the RSC. This term was selected to. imply . 
- capabilities which transcend normal capabilities of a SPO. This 
interface infers comaunication (via the SMCS) with a Server 7 
7 Overeaas MCP» hence the teri. Remote Supervisory Console. 


Messages input fnew the eee. to. SYCOM are grouped into two basic. 
typess Locat SYCOM and Remote MCP. Local SYCOM input includes — 
commands to initiate file transfers» request SYC OM Status datap 
and other such functions. Additionally» respond to. conditions 
within SYCOM*s domain that cannot be preprogrammed’ such as- cere 
reader not pears: clear peripherals, etCee : 


Remote MCP éoawands permitted from a RSC are basically directives 
used for control over the execution of jobs in the Server System? — 
att via the Server System's SMCS. OGUnly certain MCP commands are 
permitted from a RSC (reference Appendix Fe “Restricted MCP : 
Command Summary") for processing on a 81800/81700. Server. System. 
Should the Server System be other than a 81800/B81700 series 
computers, refer to the appropriate operating system. reference. 
manual Tor a Met of a commands pcemit ted. from. a Mee Ot SPOS 
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Figure I[-6: RSC Input/Output Message 
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atau: messages for. RSC. display can be grouped into isan types; 
they are: Local SYCOM» Local. MCP» Remote SMCS» and Remote MCP. — 
Local SYCOM. output messages are norwally responses to commands 
but can also be error type messages reporting SYCOM probtems. — 


“a Gea MCP. output would include such messaces as "NO PRINTER 


AVAILABLE" and other such information. messages which pertain to” 
operations of a SYCOM Systeme Remote SMCS messages would be 
replies to “SMCS commands entered for processing by. the Server 


System's SMCS. Remote MCP output messages inctude ‘spo type seek: 


resulting from jobs run on.a@ Server System. These messages are 
Hones pace to the User systoa's SYCOM program for eet sys 


In ‘the case where the RSC. T actuatty an application programs the 
response message 1s directed to that erogres. via SYCOM'S "progras 
to. SyYcoM" ‘neue mechanism. | 


iRetanedne again ‘te Figure tt 6s assume for exauple> that a user. 
wanted to execute a job on the Server System. Assume also that. 
the subject program and alt data requirements. reside in. the 
Server System. The appropriate command string is entered to the | 
User System's SYCOM> via the SPO/RSC. SYCOM accepts this message 
from the MCP» formats and transmits it to the Server Systems via 
the Network Controller. (The command string could also be entered 
from either a local terminal or application program. Although 


these message paths are eRuehehy.. different» the end results ane” 
the same.) | | | 7 | 


In the Server ceeced tia: rire receives the MCP eplaand: message - 
(from the Network. controtlae) and "zips" it along to the MCP. The ~ 
Server System*s MCP processus the request as asked. Alt output 
messages pertaining to that. job are given to the SMCS which in | 
turn transmits them to SYCON in the User System. User Systea — 
SYCOM then causes these neshages to be disolayed its ROE, 


From this we can see SYCON'S invotvement anc the processing. flow 
involved in this type of operation. Alt preceding functions 


described for the RSC are over and above the standard User SPO 


input/output messages used for normat User System operations. 


Since SYCOM 1s symmetricals both. systems can sep toes: an RMenxi cal. 
set of functionss providing of courses both systems are of the 
same series. Actual input and output messages are shown and 


exemplified in Section IV» “System Operating Procedures”. 
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Prograa-to-SYCC*# Communication 


The same range of functions are possible for the program-to-SYCOM 
facility as for terminal-to~progran communications. This feature 
3s made possitle by an adaptation of the cela erie cided lid 
schemes. A mechanism Cof implementation dependent nature). . 
provided which attows an application program in the User So occe 
to masnuerade as a “terminal”™. This program formats messages to 
appear as if they were terminal keycoard irput. These messages 
are then written tnto SYCCM*'s "INQ" queue for Be ees EU ge 


From this point on» at Least until a reply message is processed» 
processing is the same as terminal-to-program commands. When 
SYCQM receives a reply messages it is written to its "OUTOQ" queue 
where the application program in turn requests a “read” on this. 
queue to obtain the message. These reoly messages must also be 
formatted exactly as those created for terminal displays because 
they could be destined for terminal output. The application | 
program can then either prints stores ignores parse» or display 
select message text as appropriate for the program. 


The schematic on the following page (Figure II-7) srowides an 
overview of the mechanics for "Program~to7SYCOM communications”: 
Communication between the application program and SYCO™M is thru a 
pair of simple “queue files". [he prooram cives a command to 
SYCGM by "writine™ into SYCUM*s “GUTQ" queue file. It obtains a 
response message ky “reading” from SYCOM's "INQ" queue file. 


To convey certain basic information with these. capurvoutear: 
messages» a “header” is requirea which must contain specific 


information. This header is defined in Section VI3 “Appendix E>» 
Message Formats". There are no command restrictions enforced for 
this method of SYCQM/system control. However» this feature is 
controtted by the SYCOM parameter "PROGRAM". for this feature to 
be available, that parameter “must be” specified when the SYCOM 
parameters file is created. : | 
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Figure I1-7: Terminal-to-SYCOM schematic 
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PRCGRAM-TO-PROGRAM COMMUNICATIONS 


The program-to-program capability employs an entirely different 
concept for inter~system communication. AS previously discussed» 
this feature 1s an inherent by-product of the system. SYCOM © 
itself is in no way involved with the program-to-orogram message 
traffic and therefore» does not provide any services to etther 
program. The only exceptton to this is that SYCOM does “anprove® 
a virtual terminal position for the program communications path. 


As shown in Figure [1-8 (below)» communications are directly thru 
the Network Contrciters via a special “remote file” declared in 
each Contratiers explicitly for that purpose. Yoth apptication 
programs must have mirror images of these remcte files Cone each) 
declared as well. This cemote file ts shewn in hoth Controller 
examples (Section V) as well as toth sample application programs 
CAppendix I). : . | ; | | 


Figure J1I-8 can be used to visualize how an application progran 
in one system can communicate with a prograt in another system. | 
The input/output path ts for the proaram to accept input messages 
from the Network Controller and return outout reply messages for 
transmission to the other system/program. It would behove the 
developer of these application programs to design a specific set 
of messages which exctude any terminal connctations. This could 
greatly simplify development efforts extended for these proegrams. 


The User System 


Tre Server System 


eee eeeneresomoee#eneanee#e#enhHeeteee@ @ 
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Figure Lli-8: Program-to-Program Schematic. 
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To. convey. certain required basic sneered tion HTeh: ihese: inouese | 
output messageS»p a “header” is required and must contain. specific 


information. This header is defined in Section VI» "appendix Eo 


Message Formats". There are ‘no restrictions as to the text in 
these messages but the Length is controlled to a degree be the < 
“BUFFERSIZE™ parameter. This parameter is in ar cOnn> eeee" (ene 


| fA Ler and can be speci fied. at initialization crass 


The use fulness of this feature. is to be ‘evaluated ana’ decided: | 
upon by the system user. The SREY 1s there to be foe eens | 
for whatever purpose. 5 He 


NETWORK CONTROL 


The SYCOM User. systen is otal ly Seasiaeeed: to be the remote RUE 
Station and must initiate. the transmission of data to the Server 
System. In a point- to-point. non=switched networks this is © : 
accoaptished automatically by enabling the tine adapter and then 
Srenan gyn Handsnebing, control Bes?dge8 with the server ayes 


In a point- to-pornt ‘eeaeehed per eery es the User Systen gust calt. 
the Server System. This is. ‘accomplished by either diat-out. 
Cautomatic dialing by the computer ) or by manual diat-up (dialing 
: performed by the system operator). The dialing is done “after? 
the adapter its enabled. When the tine connection is established» 
the exchanging of handshakitig. control messages with the Server. 
System is carried out. Ina. point- to~point non-switched network 
| utilizing a direct connections no dialing is dones or possibte. 


Once this communication Link. lias been established with a server 
System» Line cosmunication is identicat for the switched and non- 
Switched networks. (The User. System and the Server Systen must 
be compatible as to. transmission rate and other such OBE TON aR: 
srereeate Sapabreroress) 7 


Conver sational Communication peoceducs 


The ‘ice telah eee dn the baste ‘conversational: line — 


discipline eaployed by SYCOM. They. apply to a Porat, OEE ed 


circuits either dedicated or switched: 
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Message Transfer: All nessage blocks are celineated by special 
characters. Messaces beqin with a “SOH" character and end with 

a "BCC" character. The message control format is as follows: SOH>» 
ARMs IM#> SIXe DAl» ODA2, message text Chlocked records)» EX» and — 
finally the ACC. | | | : 


Retrans@ission of Messages: If the transmitting system does not 
receive a reply to its last transmission within a qiven period of 
times the unacknowledged message block is retransmitted. 


Parity or Slock-Check Error Handling: If the receiving system 
receives a recognizable message» but it contains either. a parity. 
or block-check errors tt repties with a "NAK". The transmitting 
system should retransmit the message. This is repeated "n” number 
of times ("n" teing user specified)» and if the error persists,» 
either system can initiate error recovery. | Oo 


Message Idle State: If the receiving: system receives a "good" 

message» but has no message traffic to sends it responds with an 
"ACK". If the sending system has more message traffic» it sands . 
another message block. If the sending system has no more message 
traffic» it proceeds to the “message idle state”. 


Normal Termination: The normal termination of a conversation 
occurs when one system sends an “ACK™ Cindcicating that it has no 
more message traffic)» and the system receiving the "ACK" also 
has no more message traffic. The system receiving the "ACK* 
proceeds to the “message idle state”. | | 


Point-to-Point Contention Procedure 


The essential characteristic of this procedure is that after the 
end-of-message transfer» as indicated by the transmission of the 
"DLETEOT" sequences toth systems are in an idle state. Either 
system may then tid for master status by sending the "DLE-ENQ® 


sequence. This is normally initiated by the entry of a command. 
to SYCOM. , | . | : 


Master Status: If either system is in the idle state and wishes. 
to begin a message transfers it may bid for master status by 
sending the “DLE-“ENG" sequence. If the same system had just 
terminated a message transfer by sending a “DLE~EUT" sequencer | 
then there is a delay created tefore this system again sends the. 
"DLETENQ"™ sequence. ~ - _ | 
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cree Message. (easter: statat. tf the. ror ors bidding. for naster” 
status. receives an "ACK* Cindicating ready to receive) >» it may 
commence message transfer immediately. If the response is PNAK™ 3 
(not ready to receive)» the "“DLE-ENQ" sequence may be. repeated up | 
to a retry. Limit of “n* Cn being user specified)» and if no 
valid response is receiveds Commence error recovery. If the 
system biddirg for master. status receives the "“DLE"ENQ* ‘sequence 
Cindicating that the other. ‘system is bidding at the same timeds— 
it abandons its own bid and. replies tn accerdance with its ee 
readiness to. receive. In order to avoid any line collisions. when 
both systems are bidding at. the same times» the no~response time> : 
out values must be set to. different values. This is true whether | 
not. the systems are "Like™ or untiken. pe sy oh 2 


ierkiaations: “The "DLE- Eo sequence is transmitted by the system 
directed to terminate to indicate the end of its sessions and if 
using a switched Lines-to disconnect the wocem. (4: 


Transmission ‘oe: Packed Data 


once wens na wae eee ee ee mot ie, 


As in previous versions of ‘this: protocols data eewonda. within a. 
message block are separated by "RS* characters. ‘Repeated _ 
occurrences of ctlank characters are compressed out using the — 
"ESC“integer”™ mechanism. The method of representing non-printable 
characters has changed with SYCOM's fiaplementation. Printable. | 
characters are those tisted in "Appendix Bp» Character Sets» with 
the exception of the "Line Feed" and "@ELL" characters. 


It che: data records contain ‘@nty printable elaeeetee se hen nes® 
first character of the recétd “is not™ a "DLE" character. If the | 
data record contains any character not in the “character sets 
then the first character. of the record must be a "DLE" character» 
and the remainder of the record contains translated data. The 
original data is translated. such that every 4-bits is mapped into 
an 8-bit printable character. This mapping is accompl ished by 


internal translations so that each 4-bits of data is prefixed 


with a 4-bit hexadecimal value "4". (Actual data transs#issions 
occur in ASCII character mode.) | | es | - 
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NETHORK CONTROLLER 


mM MBER ee anwann = 


The Network Contrctler provides interfaces with the User system's: 
terminals and Server Systems at the hardware level. It is. 
responsible alt for direct communication with those terminals and 
Server Systems. It performs the actual data transmission (both 
transmitting and receiving) functions between two systems. The 
Network Controller accepts. data message blocks and syster control 
messages from SYCC™ and certain application. programs (program-to- 
orogram) and transmits them to the Server System. In reverser it 
receives alt messaoes from a Server System ard forwards them as 
required for handling control and distribution. The SYCOM program 
relies upon the MCP for the basic function cf "message queuing” 
between it and the Network Controtler and certain application | 
programs. This facility provides the messace paths between SYCOMs 
the SMCS» application programss and the Network Controtler.. 


Following is a normal sequence of events which transpires between 
SYCOM» the Network Controlier» and the system's terminals: 


In response to a "polt" by the Network Controllers a terminal © 
transmits a message back to the Network Controller. The Network. 
Controller accepts the message and appends a header» supplying. 
pertinent information about the messages (Ce.q.» terminal types. 
isn» etce). The Network Controtler then determines which prograa 
to send this message to and writes it into the appropriate _ | 
program's remote file Cinput queue ). (Assume in this case it is 
SYCOM.) SYCOM reads its remote file Cinput queue) and obtains 

an input nessage- Should the message be a SYCOM commands it is 
processed and a reply wressage created. The reply message 1s then 
started down the tine ty SYCOM when it writes the output message 
into its remote file to the Network Controller. The Controlter 
in turn reads the repty message and transmits it (devoid of 
heacer of course) to the originating terminal. 


The description cn the relationships of the SMCS and the Network 
Controller with SYCOMs which is atso considered an application | 
programs apply to any application program. Thus» any application 
program can enjoy the benefits of a sophisticated terminal | 
network with messacge/terminal/program manacement thru the SMCS 
and Network Contrctter. In summation» the SMCS is the message © 
controller for the system. It also provides a myriad of functions 
which direct Network Controttler functions as well as special 
purpose NCE EEG OSs | : 
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CONFIGURATIONS ANC SOFTWARE. ‘ASSoctations 


He ee een me ew a: on a om On an 


Thie. ‘Systéns. Communications Module has been designed to ‘operate in. 
either of three modess 1) as an individual entity “without” local . 
terminatss 2) as an individual entity» “with™ tocat terminalse 
and 3) in conjunction with. the. Supervisory Message Controt System 
(SMCS)3 also with terminals. Referring to Figures 11-9» II- 10>. 


a and IIn-11 Cwhich follow). system configurattons with supporting” 


software elements are showns and Besce Dene 


Entry Level Systes 


This system one guRat ser. ‘fFouides alt. be the sycom ‘eapawitities 
previously defined which includes the SPO as a virtual terminal. 
This is accomplished with the smatlest. memory size commitment. 
Although | the command repertoire 1s generally confined to entry. 
from the system SPOs speciat. apptication prograags. running in the — 
system can alternately inject. commands to SYCOM for Ppocoee nad | 


In the User sind wehebelne We Sites tare tees the | 


- communication Links between system software elements are shown. © 


Each of these Links» "queues" and “remote files"» have specific 
PUrpes es which are. Ewer y. seeocrtyed as follows? et 


A. "ING" is 2 a queue. ille. used ‘éy SYCOM as output to an 
application prodr aa. utilizing the “prograa-to~ SYCOM™ 
facilities. : | | 


B. -eguTar is also 4 Ausue file used by SYCOM as boas from 
an application prb gras utilizing the apregrem to- "SYCOM™ 
facilities. | 7 | 


C. "LINK" is a rents. Fite which is used in communications 
with a remote Server. "host™ System. Atl RJE and virtual 
terminal input/output message traffic. moves thru this 
file. This remote file is directly related to the SYCOM 

communications line to a remote host. 


DOD. “RFUSER™ is a user defined nage for a reaote file used 
. . for program-to-program I/0 message traffic» primarily. 


directty thru the Network Controllers. Atl messages for — 


this remote file move thru the same communications: Line 
as ese identified for the "LINK" Puree, 
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? Figure lI79: User System Schematic 


edit SYSTEMS: COMMUNICATIONS SmoDE 12 sep 1978 


ies tr Concepts and Facilities a2 et pte peed, 


Extended Level systea =o 


“This system ondigueat toa: alee" provides att sYcom services as. 
outlined for the. Entry Level System and extends this to include © 
tocal terminals. With terminals. SYCOM functions can be invoked 
from outside the computer room and away. frog the. system SPO. | 


Terminals on the system increase memory usace in proportion to | 


the number of terminals attached to the system and the tine or — 
lines for terminals. The memory increase however» will be in the 
Network Controller prograa and not SYCOM itself. ee 


Local terminals are exclusively owned and controtled by SYCOM. 

— Although there is no operationat SMCS required in a User System», 
it is "required" in a 81800/81700 Server System when Remote SPO 
type activities are needed. The introduction of terminats in this 

system requires another remote file declared in both SYCOM and 
the focet Network Controtler: 


Ae "TERMINALS* is the remote file used by SYCOM for local 
terminal input/output message traffic between it and the 
Network Controllers. As the contrcller handles alt — 
necessary terminal interfacing» SYCOM only reads eneUE 
fro and writes output to this remcte file. | 


B1@200/B1700 SYSTEMS COMMUNICATIONS MODULE 12 Sep 1978 
Software Operational Guide _ Page =~ GT 


Section Il Cancenots and Facilities | (Original Version) 
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81800 or 81700 User System a 


ii s-seb “eek Sc ub lg WU ss ub sas ba a: oat ss a an a a Dp mm am am a wa eet / 


eaananmneceaeaenaeneeeneneveeeaeeeaeenceaeaeonosvneeneaeeneneearernveaen ean eaaeaeneonenenenanaeneee @ 


° | | | Master Control Program (MCP) | | ° 


See ee eee aneeeneeeeeeeeeeeeeseneeeeseeneeneneseaneneseveaennaneneeene0ese 


A a | er. 


| cee ereleie ae ee ees ee re ee ee ee 

{ -— | ° _ | ; “a 

{ - Pregram to . - Program to .e 
ft e SYCOM . ° « Program ° 

! i a ‘ 3 ‘ 

| 

i 

V 


® 


CINQ) eeenene en neneeneneee eecneecesveacece 


i | A ey 


1 t es | | | ee ee ee 
eaeeneneevevene 1. . i | | a e 
. | o<"(QUTQ)-- eee ORE USER 22 2s e 
- _ | | a « Network ‘ 
» SYCOM 9 a <ee mene ===( TERMINALS )o---"--="""">. Controller . 


: |g Kotte eeece- CLINKISnceSSarseeresesre. 
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Figure 11-10: User System Schematic (terminals) 
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“Ultimate evel Systen 


He weer mmm memes nae 3 


Osiny ‘this eoniaurati ons not ‘only. are att ‘ot the capaonaeiee - 

provided as outlined for both Entry Level and Extended Level 

SyStemsSe it now provides the SYCOM terminal user with an. access 

~ to alt of the. capabilities afforded by the Supervisory Message 
Control System. CSMCS).. Memory. increases in this configuration. 
are purely. related to the ‘Sucs and thee Network Controller. 


tocat terminals in this system eons igers taon: are under direct. 
control of the SMCS. Upon command (SMCS “sign on™)» a. eee.’ 
- is temporarily “attached"™ to SYCOM for functional directives. 
When SYCOM activities are completers the. terminal is “detached” 

. fron. SYCOM with the " -38YE". command and is again under the control 
of the SMCS. AS such» an additional termiral 1/0 communications 
Link is needed. Also» in addition to this link» the remote file | 
NTERMENALS is effected somewhat. S8oth are described as follows: 


Ae "MCSREMOTE™ is a remote file used by the SMCS as a Link 
to the system's terminals. Alt terminal I/0 message 
traffic between SMCS and the Network Controtter passes | 
thru this file. During the time a terminal. is “signed=- 
on" to SYCOM»s — certain messages are "switched" to the — 


SMCS for processing (those messages pee ine: ails a SMCS 
ASV Gna; character" ). a 


Be TERMINALS" is” SYCOM's| Penotes file for. cewiaal. jesus 7% 
output message traffic between. it and the Controller. 

The stight difference being that terminal input/output 7 

only passes thru this file for those terainals that are. . 

"signed-on™ to. ad rw 3 eae 3 i 
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Figure II711: User System Schematic CSMCS3 terminals) 
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et Fe aes 


Ia ender. to decerabe: the potential message communication paths 
opened up by the virtual terminal capability, a special message 
path syntax was daveloped to pictoriatty present. this myriad of 
possibilities. The message path Syntax 1S easy to understand as 
cne can visualize these logical paths thru the User and Server | 
Systems. .System software elements are easily recognized by the | 
widely used acronyms Call defined in the "Glossary™).. Although 
the directional flow arrows “-->" indicate a single direction» 
communications are twomway. The boxed in syntactical elements 
to. the right. indicate an alternate message path;. also available 
thru the "virtual terminal" capability. . 


For the Entry Level system 


os ~~ —aR.® eS wee am wD ae ae 


For an “Entry Level System" (Figure 11-9) nene are. three message 


- gaths for SPO input. The pees examples ea each of Nese 
possibilities: — | . 4 


User Systen ; ‘Server System 


Te 
SPO <*> MCP --> SYCOM <---> NC -ene-) ea 
| : - 4 | . 
: ne NC so SYCOM = 
a SKKKD oseee> SYCOM | a od Ge at ee oe 
XXX tt teen ete ncn www e ee neneennee=> SYCOM so-> spo 
ee | ry | 2 


As shown. in this aiagram, all inout command strings are given to. 
User SYCOM by the MCP. Messages prefixed with a oeriod "|" are. 
orocessed by User. SYCOM. Alt other input messages are gent: to 
Server System*s SYCOM which ae them cn that SPO. When the | 
"virtual terminat”™ capability invoked Cty. using the ".CONKECT™ — 
command)» then the fottcwing wae page | paths are established: | a 
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User System t Server Systen. 

-— —m- am ah 4 ee we a meme em et em ee meen mn ny Beem e mem nememm anna man 
| | a i 

(@ CONNECT <-->) © «6SYCOM | i 

| { 


eaeneeenvneeeneneeeseneonaneeeveeeneneneneen 


SPQ -7> MCP =2> SYCUM -cf""> NC tee 
| ; : | / | s 7 
: icici NC =2="> SMCS. 
| | — ; 
2 <XXX> "=> SYCOM | { 


CXXX> 0 ee eeeecene ween nnn nena --- wee enne--- ---> SMCS 
2EXX> see eee eon------ ween ne nn nnnne--> SMCS) =m-> MCP 


2<nnn> By fre cae ed ee en eet ee eee ee Ane ann annaoawananne een) SMCS. ==> MCP) 


I f eae is no SMCS cureently running in the Server Systems then 
the message string. intercepted by the Network Controller which 


causes an error eau to be displayed on that system's SPO. 


When a SMCS is running tn the Server System,» the SPO operator can 
either "sign-on" to a program in that system or initiate RSC type 
commandss thru the SMCS. When the virtual terminal is signed-on | 
to the specified application program» it is “attached” to that 
program. ALL further non-orefixed input ts sent to that program 
for processing. (CIn the exampte belows the "$" character is 
assumed to be the Server System's SMCS "signal eueraceerts tt 
cou be another character.) | 


Yser System 1 Server System 


ee ee en ES eEeene ee a & -— - 2 a eS a a am wt ee een ten meme een eee new en ann 
“SIGN ON AP ==-=> SYCOM \ 
Ss 
SPO <--> MCP <-> SYCOM ==--> NC ----- : 
SS. - 3 : | 3 
: escss HC: Seee> ap is 
: \=> SMCS 


(2G WSdNSaiwwds <4556 Sees eee ewes oes be 


ee | - 
ee <XXK> => SYCEM ae ; 


CXKX> Sees eam ann sana ma nam ee ee ee 5 aati fa ical clase? AP. 
B<XXX> i, he eee = 7 oF = op =D Se eee mane mama a> SMCS 
BISXK> se ecceeceeeH mmemn rene etnnens==> SMCS f=-> MCP 


BP KnNN> peer ee een neces e eset mennene=> SMCS 2=7> MCP 
- | io 2 ee 
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‘Progr an-to- SYCOM input: 


oveeien peat nel einen on lee mse Ro mmr eee o ena seo 


ee ee SYCOM™ communications» the tollowing message path 
assignments are available: | 4 We ok ee ee 


Nese system A Server System 


AP (seen een eee-> SYCOM -cees=>. NC -==se5- | = 
ae | . em cad : i es | 4 er ee 
3 eee = "NCL eae ee 57.0 OM = 
pee gs - at fae ay or, i 
ee SUXKD tees sycom” er ee ee | 
“AIK? , SEP see eter osesaeeesaen sna Ssaas> SYCOM 2--> SPO 


ne anak command strings are given to hear SYCOM by the MCP via 

the "OQUT9" queue. Messages that are prefixed with a pertod "." 
are processed by User SYCOM. AL other input messages are sent. to 
server abdul S SYCOM which Se ee them or boa ‘Spo. | 


| When: ie “virtual iérninat® capability Vs invoked (be entry of ae 
— "CONNECT" command)» the Peon mes as vety are established: 


ieee _systew te Server system 


60 08 60 08 


ett ea ee a of 
CONNECT 2 > SYcoN a | 
AP weer enn ew nn > SYCCM ee--> NC “seco 
a _ | aa | a _ . eae 7 : 
: — See HNC Sore: SMCS 
: er a ae | at 
o <XXX> eet SYCOM re Se a i a a. ee 
SE XXXD et ee ee wm mm ewe mm meen mmm wow e aman mmnmy SMCS 
RB EXX> | sia tetadataetatelatetatetatatehatatatetetatatatateitetehat SMCS ta t> ‘MCP 
2 Ennn> i aa a aaa all a mame —=)> SMCS ‘ seas MCP 
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If there is no SMCS currently running in the Server Systeme then 
the message string 1s tntercepted by the Network Controller which 
Causes an error message to te displayed on that system's SPO. 
When a SMCS ts running in the Server Systems» this program can 
"sign-on" to a program in that system or inittate RSC commands, 
thru the SMCS. When this virtual terminal Corogram) signs-on to 
a specific application program» it becomes “attached”. All non- 
prefixed input is sent to that Server program for processing. (In 
the example belowe the “$" is assumed as the Server system's SMCS 
"signal character"™s it could be something else.) 


7 User System | Server System 
‘ mh 2 ah wa Oe OOS Owe ween eS wow Ee Ge a a me 6 ap 4 ~ Bw en am awa 4 =e ap 2 on mH aD OU De EEE DRE OO 2 & 
| | 
SIGN CN AP =-"7> SYCOM ; * 1 
| 44 


@eenvepseevnaea G@eoeeaeeveeeaeeeesenvnasnevnananenneonenonne e228 0868 


AP 0 ww enenee me2=> SYCOM =--> NC seee- : 
are , eae | a 3 

: sccee NC tee => AP : 

: \-> SMCS 


een een eneaeseeaseaeenee ee neaeeeneneaneanennee 26a 


S<XXK> ===> SYCOM 4 


<XXX> we ee wee eee em menen wow ewe meee mm eeen= weeanwama=> AP 
B<XXKX> ‘ere eere= om cee een anes Ssocss easiness ee > SMCS 
eS MM a aa eeem==-> SMCS “==> MCP 


$2<nnn> cceccetec l= wom er acces eneeeen=> SMCS) =="> MCP 


Program-to~program input: 


a OOP OR EP a OR EP ED OD CRY OE) a ee em GHD aD te <P CER we -eeD ED a a 
ee Ee EE NO NY ED AY ER ORR EP me om aH cum wa a a ame ee wee omy «ane 


The message path for progran- to-program com@unications is timited 
to the following predetermined path. Messaces can be any format | 
and contain any text agreed upon by both applicatton programs. 
The onty prevailing restrictions are maxisua “buffersize™ and alt. 
messages must be prefixed with a “header” ("Appendix E™). 


User System j Server System 
-—- oN AED DD OD A OO ON SE A On OD GD OD OD mE OD OD om OD oe an em oe om ama ey SSIS SAS Se ae Se ee 
AP ww ew we we ew wwe ee me ew nnn NC nm ae 
-e--- NC ---=> AP 


| steco7e1709° SYSTEMS, 
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For the Extended: Level Syster 


— this. cone cu son Ce iauce 41- 10)% the seo id aN terminals : 


attached tor ang cwned by» SYCOM normatty communicate with. local 
 SYCOM. When the virtual terminal capability is utilized, these. 
devices are persitted to communicate with either the system. 


‘eo programs: or aperopriore application BEOnr om in a- Server 


The SPO» proqram-tc~SYCGM» and program=to-program input message 
paths for this software configuration are the same as those. 
defined for the “Entry Level System". The telow message path 
assignments are for Local terminals attachec to this system: 


User System, ! eee er System 


om | 4, hh a _ a ' 
VOT --> NC ==> SYCOM — 


1 

f 

ee SXXX> tt e=> SYCOM | 
| { 


By entry of the " CONNECT" command to SYCOM the virtual terminal 
Capability is invcked. The following messace Parnes are then 
established for the terminal: : . 


—eCONNECT  ceee> SYCOM a 


VDT ==> NC =*> SYCOM ses-> NC =en-- 
Sef ch 4 , PPT NO Vv aese> SMCS 


Dee cet e ee eee cee e ences cceecnescenscee — 


Ad oe 2 eer 7) eee ae qt 
8 <XXX> oo te==> SYCOM 4 
ae 2<KX> Se ee eee “sucs” . rs WEP 
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If there is no SMCS currently running in the Server System» then 
the message string 15 intercepted by the Network Controller which 
causes an error message to te displayed on that system*s SPO. 


When a SMCS is running in the Server System, the terminal user 
can either “sign7on" to a program in that system or initiate RSC 
type commandss thru the SMCS. When a virtual terminal signs-on 
to a specified application program, it is “attached” to that 
programe Alt further non-prefixed input 1s sent to that program 
for processing. (In the example bellows the "$" character is 
assumed to be the Server System's SMCS "sianal character", Tt 
could ce another Coaracl ete? 


User System % Server System 
am SSS aS SSS SSS SS ee 4S aS Se ee eS aa ae ee See ee ee mee ene ie ee ee eee 
| | i | 


@aeeceoawoee1eean*)etsmeeseesteaeaeoeenseon@e@seaenaea2edaeeeeeeeoee eg e@ es @ 


VOT "> NC => SYCOM ce==>. NC cee 


e---- NC <---> AP | 
| _ \7> SMCS 
o <XXX> => -sycom ! 


~ 
oo 86 08 28 08 


<XXX> A eee ee ee ee eee e men en seen e ma ennme nse mee n> AP 
SEXKK D> erences mew enn wenn mame ammennnemememenren> SMCS 
BIPKCKK> tence eee e ne nee nen n nn nnn -- ---> SMCS <---> HCP 
T2502 TESS STS ees eee ee ee ENS. Pee Nr 


For the Ultimate Level System 


In this configuration (Figure Tiv11)» att tocal terminals are 
attached to» and owned oy the SMCS. Therefores the normal message 
communication path is to the User System's SMCS. When the virtual. 
terminal cap ability is utilized» these terminals are permitted to 
communicate with either system software programs or acnprooriate 
application programs in the Server System. Aaditionatlyes these. 
same terminals are permitted to communicate with any appropriate 
application program in the User System. 
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The. SPGer progr aa-tomS¥COMs sid: proaram~to- ‘program input message. 
paths for this software configuration are the same as those | 
defined for the “Entry Level System” - The following message path” 
assignments are for alt tocat. terminals. attached to the User oe 
System? § SMCS. First the normal message We for. terminal input 
withia Oe, Lser ey atee are vreeanvcee | Paes 


e | User systen z| Server Systea 
_ oe. | _ & | 1 
VDT --> NC ==> Smes 


 €XXX> se ee> SMES Pax & 
asia! - mone SUCS . ~e> MCP. 


In ‘order for. the ‘terminal user to gain access to the eysteuts: a 
SYCOMs the terminal user must enter the S¥CS "SIGN ON" command as 


shown. below. CAlthough> this example. is for a sign-on to. SYCOMs it | 


could be any - “AP PEOp Eats sgnO yee eter progranr in the User. System.) 


ts  F, Ree oe, ee ee 
SIGN ON SYCOM seerrnnm> SMCS ot 


The fotieutns message path assignments are then in effect for all 
Feet ees | | 3 eas 


88 0 


a oO NM> SMCS =f 7° A a ore 
| . Se 7g, REO NE See: SVEN: is 
SiN 2s 1) SReR cae ne eae shinee Seems ¢ SY CUM See eSP OU: . 


_ <p PERN SESS a GWES™ iSe>. 7 MOR 28 Ul. 
eo wOoSnOnns SA5°5>.S4CS sso: MOP? 1 
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The "virtual terminat™ capacility 1s invokea when the terminal 
user enters the “.CONNECT" command to SYCQM. Following are the 


message naths now established for the termirals if a SMCS is not 
currently running in the Server System: | 


User System 1]. server System 


meee enenewm@ee. 82 @ 2 ae ma ae Oh a 0 aD SE 68 OD ee ee Oe ee ee ee 8 ae an anw waa ap am an am oe Se oe ee ee ee ee ee : 


eCONNECT er -7> SYCOM oo § 
1 


eaaeew@enveevnenenesvneeaneneoeneneeaennneannnee ee 80 8 


VDOT =e > NC oe ae SYCCGM a lara NC ee! “s 
7 | \-> SMCS) ot fo : 


a —_ { 
o<XXX> c2"=> SYCOM | a 


EXXX> want eee we wn n ween wwe cnn wen eee n een ecneen=> SMCS 
#EXXX> ceee> SNCS | 
K2EXKX> see-> SMCS => MCP 1 
*?2<nnn> eee7> SMCS -7> MCP || 
: , | a ' 


If there is no SMCS currently running in the Server System» then 
the message string 18 tnterceopted by the Network Controller which 
causes an error message to be displayed or that system's SPO. 


When the “virtual terminal" capability is invoked and there is a 
SMCS currently running in the Server Systems» then the following 
message paths are established for the terminal: 


e@eneteaveenevnenneeeaenvnene ean vet eaneoeaenevneeneneeen 


VDT =-> NC se=*> SYCOM -"--> NC -He-- a 
| \-> SMCS ot | 7 | _ os 
Ys _& 3 Serer NC ere SMCS | 


e@oaneeneene eevee ennaeveen eee eee2eeeneneas eee 


0 <XXX> =s""> SYCOM { 


CXXX>’ Ser ere eer essen Sesss wacene- “--> SMCS 

ZOXX> [ae setecenceanenemnwnn momeemmme> SMCS > MCP 
~~ 2 SOR? SPeee sso sSesea- SSS ee eee m--> SMCS <--> MCP. 

*#<XKXKX> cece > SMCS - i a | 2 


we 2PEXK> eee > SMCS ==>) MEP | ! 
«2<nnn> -"-2> SMCS > “MCP 4 
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with: the SMcs. running in ic isbeuae Systens a terminal user can 
- either. "sign-on" to a program in that system or. initiate RSC type 
Commands’ thru the SMCS. When a virtual terminal ts signed-on to. 
a specified application program» it is "attached" to that. program. 
until the terminat user "signs-off™. All non=-prefixed input is 


sent . to. that. application program for processing. (In the examples — 


be lows the "*" character is assumed to be the User System's. SMCS” 
"signal character" and the "3" character is assumed to be the 
Server System*s SvCS “signal character} they can uke different. 


User. System , Serer Syste 

oe - * les 2 | = 44 i? a | | 
SIGN ON AP. Sees e esas e4 SSS See sa 26 See a Rae a= > SMCS . 
. a a ; a ; aa . | | ; : 4 . : - 


VOT ==>) NC aden dil folie 4 ---+-- 
Pee TEN ‘\=> SMCS . 


~ 
90 90 06 a8 60 


NC se==> APO 
| Ne SMCS = 


@#@eees Py #eeoeonog202020608827090898 &290 @ ° a#ee @ @: eas 2 eee ad a © 


se 00 66 
| 
| 
| 
t 


2 SXXX> seen > SYCON | - % * oa! 

REXXKD> oo terem> SMCS 

we 2KXK> seen > SMCS --> MCP to 

—« 2enan> cere e> SMCS ==> MCP. A | 

ORISSA Se Oe ee ae a er a A 

EB EXKXXD teeter enw mec ew wn ens e nn ne seme ee senmnweemen> SMCS 
_ ESKKS: (Secs <= eees sass SSeS oH ees s> SMCS ==> MCP 
BPKNAND orem erence mennwnn ame ccnn rere agar eee ae 


re DEPTH CONTROL 


ss tchatlllcinseelleta atid ited saltdchudidtesetntaiees siitasd ane ne tee en 180 cm ee ante 
FO A OO eo ERR ee ate SE OREN CED GEER ER -ewn ~ens 


In the SYCOM operational environment» there is a MCP controlted 


data path which exists between SYCOM and the Network Controller. — 


This data path is referred to as the "remote file™ Cor message 


queue) mechanism. Due to differences in data communication tine 


transmission rates and perioheral input speeds» this remgte file 
becomes a buffer. Without some kind of control on the message 
traffic thru this file» it coutd grow beyond reasonable Limits or. 
fe jammed full. - ot ee i Re ge ee fone 
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To provide a control over the number of message blocks that can 
be queued up in this file at any given timer a “marker message" 
system 1s employed. As SYCOM is putting message blocks tnto this 
files a count is maintained. When this count reaches the halfway 
point of the queue depth limit» a marker message is put into the 
file. fhe marker message is a specially prepared data message 
with a code in the message header. This special code ensures 
recognition by a when this message is echoed back to from the 
Network Controltle | 


Once a marker message is placed into the files SYCOM continues 
putting message blocks into the file until the predetermined 
queue depth Limit is reacheds at which time peripheral input 
operations are suspended. When the Network Controller encounters | 
the marker message during the transmission cf the queued message 
blocks» it acknowledges receipt of a marker message by returning | 
a “flag” in the corresoonding "ACK" message to SYCOM. When SYCOM 
receives this acknowledgements it resumes peripheral input. again 
places a marker message into the file and ccntinues putting | 
message olocks into the file until the predetermined queue depth 


is reached or until an enacof-file conditions whichever occurs 
Vivek | 7 


SYSTEM FILES 


00 wae owe ae am ee ee ee ee ee ee 
wee cmd me ee ~WO E ee  GE ee eee 


In the total system pictures there are many files and file types. 
However» as this system overview pertains cnly to SYCOM and its 
relationships» only those pertinent files which are required for. 
SYCOM operations are presented. . Following are file descriptions» 
by software elesernt» that are necessary for SYCOM operations: 


MASTER CONTROL PROGRAM CMCP) FILES 


(SYSTEM)J/USERCODE File 


This file contains atl valid usercode-pnasswords that are known 
to the system-e [ft is used by the MCP to enforce file security 
disk files and programs/users that access them. With this file>» 
the MCP can service any requests by proyrams regarding validity 
of SPC OEING usercode™ password combinations. 
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NETWORK CONTROLLER FILES Ly 


Network. Information CNTF) File, 


This file contains tables that describe the ‘anveiesl’ and houtest 
attributes of the network. The initiatization values for lines» 


terminats»s and tile tables of Network Contrctler are contained in 
this file. This file is created by the ACL compiter when it is 
in the process of generating a Network Controller. a 


ee bidessteleictats 


The “Systems Communications eddie” eee many ey pe< of files in 
the management of its domain. There ares oeripheral Cincludes 
disk)» remote ccmmunications» and queue files. These files are 
briefly descrited here» under separate headings» with detaid | 
descriptions for major files available in athe appendices. 


Perioheral Files 


Tees ites are qenersy er to Goa yourcue’ RIE type. data and: 


include the cara readers card punch» line printer» magnetic taper 
and disk files. Also there is a disk file which is used by SYCOM. 


to manage the various options and settings. Fottowing— are general 
descriptions of ENS: SYCGM files which fall Into this car egecys 


he PARAMETERS Fite 


The. PARAMETERS oie: is a bonne le record file containing | 
required operational parameters for SYCOM. It is static © 
and can anty be changed by removal and recreation. | This 

file dts created by SYCOM- upon the entry of appropriate 
parameters from either the card reader or the User SPQ. 


8. Card Input File 
This file is used to input RJE cara data files from the 


system's card reader. It can be either a @%-column or 
9Y6~column device. ; 2% 2p, 2% 7 
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This file is usec to punch RJE cara output data files to 


the system's card punch. It can be either a 80-cotumn 
or 90~column devices as appropriate. 


Printer File 


This file is used to print atl print fites that are | 
beings or have beens received frcem a Server System. The 
line printer device can by any one of the vartous models 
which can be attached to the system. The device can be 
either a 120-position or 132~-position Line printer. 


Remate Files 


The remote files are used in communications between SYCOM and the 
Network Controtler and SYCOM and either the terminals or SMCS. 
There are two of these files which are described as follows: 


A. 


LINK Fite 


The "LINK®" file is used for atl ingut/output messages 


relating to RJE and file transfers; specificalty>, 


station types for Controls» SPO» Cards» Printers and 
File reccrds. 


TERMINALS Fite 


The “TERMINALS” file 1s the commurication Link between 
SYCOM and the Network Controlter for tlocat terminal 
messages. This remote file its howeévers only used when 
there are local terminatss controtled by either the 
SMCS or SYCOM. | | 3 
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—. Soak 


‘The queue Gites are utilized ty sycou ‘dee tuffered communications — 


_ between itself» the MCPs and the Network Controller. The purpose — 
of each of these cueue's is described as follows: = i 


RIE Queue 


‘Usedtors save SpantEed oon data eceied hoe he other — 


system when the User System's printer or punch is busy. 


. LINK Queue 


ies Used ‘to Save input messages oe the other eyetea’ 


during the "initialization™ pheses ait es Sohal ae 
lost in the onu renee | a ee ee i. ar 


20 ised ee: save “output messages. for the other system 
ee mmesedges aueuedr exceeds Seen nena s 


INQ Gueue 


This queue 1s ‘the wechani sn aos Mahan SYCOM sends reply. 
messages to an application program dealing in progran-_ 


— torSYClme communications. SYCOM “writes” into it and the | 
application proorer "reads" frog It to obtain messages. 


vee 7 


This queue 15 ihe mechanism oie: SYCOM. receives tnput 

commana gsessages from an application program that deals | 
in program-to~SYCOM communications. fhe application | | 
prograg “writes” into it and “sycow "reads" from it to. - 
enene anOue nessa sess | | > 3 
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RESTRICTIONS 


we ae fe mee eee ee 
we OP ee me ae ee ae ap ere oem men 


The following restrictions are valid for the system based on a 
logical evaluation of the system's requirements: 


- Maximum message block size = 1959 bytes 

‘ Minimum message block size = 78 bytes 

. “wan eun eveuttaneous sees connections = 1 

. Maximum message block queue certh = 255 

e Maximum numoer ayers auedes to process = 99 
° davenae number of terminals supported = 15 

- Maximum number of card readers supported = 1 
: Maximum nugber of card punches supported = 1 
2 Maximum numter of line printers supported = 1 


o. LOAD. DUMP tapes are not supported for file transfer 
operations. 


° Between unlike Systems» only fite transfers of code 
files and 8-hit data files are allowed. | 


: Only “data type files" are file transferable between 
disk/tape and tape/disk (codes files are nvatidd. 


- Multi-voint rateeks are not suppor ted by SYCOM>s 
at this time. 


- Message tlocking is prohibited. (A message block 
already contains multiple recerds or data images.) 


« Monitoring and controlling of programs in the Server — 
System requires a SMCS executing in that a | 


- ‘for ayetews using "hinary-synchronous™ transmission 
lines» the NOL generated Network Controtler requires 
certain changes in the area of "“NAK"™ conversions. 


These restrictions may be changed during. subsequent develooment 
cycles» but are however, currently tn effect. 


SECTION tr! 
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COMMANDS — 


BL°AA/B170N SYSTEMS COMMUNICATIONS MODULE 12 Sep 1978 
Software Operational Guide 7 | oe Page - 65 


Section [II Commands | , (Original Version) 


SECTION TIT | 


COMMANDS 


GENERAL 


wn cn eR ew on ee 


The commands avaitable with the Systems Communications Module 
CSYCOM) are described tn this section. These commands are used 
to give SYCOM directions as to specific actions which must be 
executed in order to perform the required tasks. The commands 
are presented alphabetical order within two aroups» those. allowed 
from terminats and those restricted to entry from the system SPQ 
or program. This Ways the terminal user need not. he encumbered 
with the details of SPO commands? which are not permitted. 


To ensure that each command is physicalty separated» a unique. 
format presentations which 1s described helcwe has been developed 

for this document. This scheme of formatting presents commands 
in modular format which allows for expansion and change without 
significant disruption ot existing. syntax. 


‘COMMANDS. 


oe am = ep A ee ee 


1 ee eae nD NI me rR one 


Each statement in the Command Language corsists of a command ands 
in some caseSe a list of parameters. The parameters in the tist 
are separated from the command and each other by blanks. In the 
following examples sinale spaces are used although the use of. 
tultiple spaces between command elements ccutd te used. 


Hhen the SYCOM has. finished orocessing a ccmmande it aiapiars a 
reply message either confirming successful completion of the 
coswmand or indicating an error. Errors terminate the processing 
of a commands the entire command must be re-entered correctly. 
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“COMMAND. SYNTAX. CONVENT TONS 


The notation: Conventions that. are dea chibed 2 oie ate weed 


Set arity this: section to describe the syntax of Sack ‘command. om 


Notation used in nodet format. 


In the modet example given 


Brewer’ a odee oe a dowaane. is” presented. “this. gives the user can 
overview of the potential of the. ‘command structure. 


a -COPY <file- name> > C (USER ‘<usercode>)} CAS | teen ee enee-> : 
a ONTO OS ak af a 8 
oy. eee <file-name*2>] FROM CHOST=<id>) TO CHOST=<id>) % : 


BRACKETS: — inforsation. thatsts. enclosed within brackets. . 7 
represents an option which may be used or omitted by the user. 


dAbOves | the options USER» AS or ONTO> 
and "file-name-2" indicate. three possible choices when using 
these optionse or the choice of not ussn9 ‘any Cette 


BROKEN BRACKETS: Left and. Biante broken <> brackets are used to _ 

indicate that the enclosed variable within the brackets must be | 

_ replaced by digits and/or. letters whose wave? is determined by 
the context of the command. | 


aupieca. CASE LETTERS: Words that appear in upper case ‘letters 

indicate that the word is a literal and must be substituted 

werbatims when used. In the model given aboves the word -COPY 
Mone. be entered ee when constructing a Comeand,, statement. 


LOWER. CASE LETTERS! Words that appear. in lcwer case letters. = 
indicate that a value must be supplied. In the model above» the 
word "file-name- 1" tndicates that a character. string. cere seng 


ogee name of the eee to be copied must be entered. 
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COMMAND STRING SYNTAX CONTINUATION: A few cf the commands have a. 
considerable number of syntactical items which overflow a printed 
line into two or more command string Lines in the presentation. 
To provide a clear tine of continuation for the command stringe. 
the use of line direction arrows are used.e A line direction 
arrow appears as c--77-> and always flows teft to rights to 
continue the command strina. It is easy to fottow a command 
string in this format as it is logical in nature. 


END GF STATEMENTS The end of a command statement is indicated by 
the appearance of a % (percent sign). It ts only a syntactical 


string terminator and is not required text for command input. | 


OPEN-CLOSE PARENTHESES (): When these characters appear in a 
command syntax statement they are required incut. See the "COPY" 
command for a use reference. = 3 | 


SLASH /: When this character appears in a command syntax | | 
statement it is required input. A space cr spaces on either side 
of this character are not attowed. | | 


Punctuation fules 


The spaces the commas and the neriod are considered punctuation 
marks Cexcept in Peete and are used as follows: 


de The space (blank) is a Pepgeaeers seni red .21eer- cords 
and literats in the absence of any other separator. A 
space ay precede or follow any other separators and 
many spaces are the same as one Cexcenpt in literals). 


2. A comma is a separator phe Aer ieedk wale where it 15 | 
soecificatly indicated in the commard syntax. The commas © 
where it is tegal» can also serve as a terminator for 
words and numeric Literats. The comma is never required 
except te separate criteria in a command string. © 


3. The pertod 15 a paauiead prefix to tocal SYCOM commands. 
It is never required within any command string syntax. 
Its only acceptability would be as an embedded character 
in a file name» system identifiers or usercode/password. 
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: Re RO Rane OS ee @ Oe mee me wn Oe Oe me 


Error. messages specific to. the fot towing SYCOM commands appear in 
“Appendix: A (Command Error Messages). 


COMMAND | SET. 


| The command set wader follbwes: is used to direct SYCOM coearathe i 
from either the SPQ» a system terminals or an application progran | 
running in the system. Non=SYCOM commands are atso permitted to 
direct User and Server System operations via respective SMCS‘*s. 


This command set is separated into two subsets? 1) commands which | 


are permitted from any device and 2) commards raservered, to a SPO . 
or apiece" appb rc anyon program. — | | 


Terminal Commands 


The following commands are permitted from terminals. They direct 
file transfer and remote Server System operations. Although these 


. coma@ands are for terminals» they are also permitted from the SPO. 


and special application orograms used for system control. However 
when these commands are entered from the SPO» the command string 


must be prefixea with the *job number" eS otened” to SYCOM MEE er“ 


ir an ed and then the command string. 
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~ ABORT 

Function: The ABOKT command is used to force SYCOM to "abort" 


an inwvorocess file transfers» either receiving or 
trarsmitting. If “fetching” (receiving)» the fite 
created up to the point of aborting 1s either 
removed or purged as appropriate. 


Syntax: .ABCRT FETCH % 
; PUT 
semantics: FETCH = causes the FETCH in-process to be aborted. 
Pul = causes the PUT in-process to be aborted. 


Defaults None. 


Example 1: (Kilt off transmitting the current file.) 
Input: --- .ABCGRI PUT 


Reply: <-> PUT OF FILE <file name> ABCRTED 


Example 2: (Stop receiving of incoming file transfer.) 
Input: --- .APBGRT FETCH 


Reply: --- FETCH CF FILE <file name> ABCRTED 


Note: If a file transfer is not in-process when the 
, , ccmmand is enterede an apprcpriate error message 1s 
returned. | 7 | 


eeaeaneneanenenee2n 8 @ @ 


- ss ABORT 


eeeveesensveceseon 
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ile 


h@ 
Wm 
im : : 


Function: 


This command comptetely logs the current user off 
 SYCCM. It is walid from alt stations inctuding the 
system SPO and application programs. The following 


sequence of events transpire when it is entered. A 


"Byer text message is sent to the other system to. 


cause a “log-off" from that. systems the usercode is 
removed» an automatic "DISCONNECT™ is initiated» | 


and a "detach" message is sert to the local dae 


if the terminal is not owned by SYCOM. — 


Syntax: 
‘Semantics? 
Defaults 


Example: 


Input: °-- 


Reply: --- GCOOBYE: Cusercode) LOGGED OFF SYCOM 11:45:32.1 


Notes 


—eBYE 2% 


None. _ 


Nonet 


«The initiating station need not be "logged-on". 


 @@aeeneeneneee0 


hog, 5 saVerre 
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el Ee ed 
> eae ner eee 


Function: | 


Syntax: 


Semantics: 
Default: 


Examples: 


Input: -*c- 


Reply: --- 


Note: 


The CONNECT command is used when a terminal user 


wishes to he tlogged-on to a Server System. Upon 
entry» the Lser System goes into “ontine™ mode» 
attempting to establish communications with a 
Server System. | | | 


It a connection currently exists to a host Server 


System» the existing connection is utilized to 


attach the terminat to that system. oa = 


message string = this optional message string can 
| be either a text character string 
or a valid usercode/password for 
aprogram's tlog-on. 


When no “message string" is specified» the userts 


usercode/password is forwarded to the other system 
if availables else blanks are sert.. 

(Request attachment to the Server System.) 
eCGNNECT US MY/USER 

".CONNECT* INITIATED 

[If the Server System is accessed via a “switched” 


tine and its telephone number has teen previously 
established by entry of the "“FHONE™ commands then 


this command initiates an automatic dial-out.. 


- CONNECT . | 


or Se ee oe ee ee ee ee i 


Function: © 


Syntax: 


Note: — 
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Bae is the éodwand which is. used to initiate tite.” 
_ transfers”. The command syntax provides for the 


transfer of files "from" the initiating system to — 


another system (a PUT) and from another system "to" 
the initiating system (a FETCH). The files can be 


In either magnetic tape or disk form and the only — 


restrictions that apply are those identified in cco. 
a “Restrictions™s» Section It. _ 


(toe> PASSWORD=<password=1> ) 0 ceenecesernennen ne 


===> CAS  &fite name-2> E Qiser=<usercode-2>- vie 


GNTO 


---> PASSWORD=<password-2> ) 1 ] eeeenn-e--------> 


mee FROM. C<volume-1>] [KIND=PACK »} | aes ae ae 


TAPE 
TAPE? 
TAPES. 

PETAPE 


santos HOsT=<systen name-1> ) TO C<volume=2>1 0 -=---> 


TAPE 
TAPE? | 
TAPES 
PETAPE 


---> Cesina=encr >] HOST=<system name~2> ) = 


An important point to remeaber is. that the "parens” 
are REQUIRED syntactical elements as welt as ene | 
i ic "FROM™ eee 


 @e2 eeenenenaneaeono 


a ar oe ; COPY e. 


7 | . o | 


- @e@ec eneeneaaneeo | 
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Semantics: —file-name-1 


—usercode-1> 
password] 


ONTO 


file-name-2 


usercode-2> | 


password-2 


volumerl 


KIND 


systemrid-1 | 


Page - 73 


COriginal Version) 


the actual rame of the fite to be 
transferreds inctuding multifite 
identifiers» if any. 


the usercode/password values which 
1centify the user for purposes o f 
verifying access rights to the 
specified file. | 


‘means create a file with ‘the name 
specified as “file> name~ 2". - 


means write cver any svibetaG file 
with the nae specified as. 


—"file- namewZg". 


ery to be given to the file that 
1s trans ferreds at its destination. 


the usercode/password values which 
specify the security to be placed 


on the trans ferred file once the 


transfer has. been coeprereds 


the yack tia “tee: where the file 
to be transferred can be found; 
providing the following KIND option 
is equal to “FACK™. This option is 
not required for files on magnetic 
paee.. or. ‘system disk. | 


one of the iavwonds shown which 15 


used to describe the peripheral 
device from where the file ts to be 


transferred “from™3 if other than a 


system disk. 


spectfies the “system-id” from 


where the file is to be transferred 
frome. oe 


 '@ @ 8 0808298 8 060084 @ 0 @ 


ey a 


oe@eeneeeeneeeeet &@ 8 
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C  etienreaiiitccnsdillacaadiieasalioere.. —_ am am ae 
on ee A cy A ee ee a ae en a 
Wee Sal” eM eye SL 


|  neank eae | 


7 (continued) 


Defaults: 


Options: 


om ep saan ome 


- votume-2 7 
KIND 


systemmid~2. 


Page a Tees: ‘ 


“original: version) 


the “pack-id" to where. the file is 
transferred; providing the. a 


following KINL option is equal a. Be, 


"PACK®. This cption is not: required. 
for files on magnetic tape or disks — 
one of the keywords shown is aged” 
to describe the peripheral device 


to which the transferred file is to | 
be written’ if other than a system — 


the "system-id” of the systen which | 


7 is. to receive the file. 


The eynpactecat item "VOLUME" defaults to. "system 


disk" if "KIND" is also. defaulted. 


The. syntactical ‘teu KIND defaults to “MKIEND=PACK™, 


The default. for "usercode-1" and "password- i* are 


those of the Sogged=on usere 


The destination user code/password Cusercode~2 and 
password-2). are defaulted to those of the source _ 


usercode/ password. 


The destination tite name ¢ file-nane-2) devout +s ‘to 


the original flame of the file transferred and the 
mba ee TON TOE: option defaults to TAS. 


Wii syntactical Sbbreviation "DISK™ may be used in 
— tiew ‘of “KIND= PACK", | 


The: tneaee col ‘abbreviation *USER= cusestadas: 


<password>” may be substitutes for the. specified 


command eo Seno ats Pe) nanede 7 


 @@ pp eaveeenee nee 
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Example 1: (Transfer file "XY¥7" from system A to system Be.) 


Input: --- .COPY XYZ CUSER=<usercode>/<password>) FROM 
| | CCISK» HOST = USERL) TO COTSK»s HOST=SERVERI) 


Reply: --- FILE XYZ START TRANSMISSION 
er- FILE XYZ ENC TRANSMISSION 


Example 2: (Copy file from another system changing file name.) 
Input: --- .COPY DMPALL AS DUMPALL FROM CHOST = SERVERL) 


Reply: --- FILE DMPALL START TRANSMISSICA 
 w== FILE DUMPALL RECEIVED 
--- FILE CMPALL END TRANSMISSICN 


Notes; le In the 7.0 implementation for file trensfers 
| from either tape or disk to tane in a receiving 
system» if a scratch tape is not mounted and/or 
ready» SYCOM will "hang™ until the tape is made 
availables no notificaticn is made of this 
condition and no input messages/commands are 
processed. | . : 


2. If a “*usercode” is not wanted as a multifile-id | 


to the file name in the receivina systemse enter 
"file-name-1" prefixed with an asterisk “*". 


one ©4284 000080908 8 


@e@e@eaennn2neanenannen 
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Function: 


This command. must be used when the terminal user | 


wishes to terminate a session with a host Server 
System. The terminal is Logged-of f of the Server 
System when a "BYE" text message :!s sent to the. 


other system which is followed by a “disconnect” 


meSSagee. — The terminal reverts back to its previous 


state of being signed-on to SYCOM. The terminat 


user is then. free to enter more commands to SYCON. 


or sagn- ott (3 BYE). 


Syntax: 

Semantics: — 

‘Default: 
Example: 


Input: --- 


Reply: zoe 


Notes 


-CISCGNNECT z 


Nones | 


None. 


=DISCONNECT 


"STATION DISCONNECTED 


The eeruted 4a: léyicalty: ‘dameconnhected but may or. 


may not be physically disconrected. To the ts: 


user howevers the net effect is the Same s 


- DISCONNECT : 


@e0e80 ° eenene oo ° 
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Function: This commanc 1s the shorthand version of the "COPY" 


cemmand for use in specifying explicit “FETCH” file 
transfer requests. The command syntax provides for 
transferring files from another system “to” the 
initiating system Ca FETCH). Fites can be etther 
magnetic tape or disk Cin any combination) and the 
only restrictions that apply are those identified 
in Section JI» *"Restrictions™. : 3 | 


syntax »FETCH <file-name-1> { CUSER=<usercode-1>>» << 95'S => 
---> PASSWORD=<password=1>)] caer ener rece rere seae=> 


“--> CAS <file name-2> CCUSER=<usercode 2>» --=> 


ONTO 
---> PASSWORD=<password-2>)] } serecesnsrccrecenn> 


tot> LFROM C<volume i>] CCKIND=PACK )3] seen n> 
| | TAPE 
TAPE? 
TAPES 
PETAPE 


tee> CTO = f<volume-2>} CCKIND=PACK )3) % 
| oo : | TAPE 
TAPE? 
TAPES 
PETAPE 


Note: . If a “"usercode™ is not desired as a multifile-id — 
| to the file name on the receiving systems then 
prefix “filername-1" with an asterisk “#*™. 


_ . @@ @@802088 8 02028 82 8 8 


me FETCH «| 


eeeeeeneneanee ene 
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“FETCH ‘Ceontinued) 


: ose eatin “ios su ‘cs eae “a since en csi.‘ se’: as ces “aan <a 


NC AN AND Cry SEE EE CU ON “ED Ee pt wee te ome ag ques” 


Semantics: 


Defaults: 


Options: 


Example 1: 


Inputs 


Replys : 


Notes 


Refer to the "COPY" command semantics. | 


Refer to the WCOUPY" command defaults. 
Refer to Pal command Feta 


eeeeaee: a copy of the “OMPALL” program fee ‘the 
Server Systems) 


eFETCH OMPALL 


“FILE DMPALL START TRANSMISSICA 
FILE DMPALL RECEIVED 
FILE OMPALL END TRANSMISSION 


In the 7.9 ieplewentation: for. file ‘transfers from 
either tape or disk to tape in a receiving Systems — 
if a scratch tape is not mounted and/or ready» | 


SYCOM will "hang™ untit the tace is made availtables 


no notification is made of this condition and no 


input messages/coamands are processed. 


e gaye ee 


8 FETCH @ 


i? i ~ © @ 


eee ee ee2eneeenane 
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Functton: This command's purpose is tc cisplay information 


about the system and its users. Command options 
orovide lists of those users currently "“signed-on">» 
terminals that are currently “online”™» and file 
transfers that are currently "“scheduted™ to occur. 


Syntax:  .eLIST USERS 2 
TERMINALS 
SCHEDULE 


Semantics: USERS 


= requests a tist cf all users currently 
*"signed-on" to sYCOM. | 
7 TERMINALS = requests a list cf atl terminals that 
7 are currently “"cnline"™ 
SCHEDULE = requests a list. cf all file transfers. 
currently scheculed. — 
Default: Currently there is no default.. 
Example 1: (List the current siaqned-or users of the system.) 


‘Inputs --- .LIST USERS 
‘Reply: --- (€<uc index>] DENNIS ONLINE 
- wme- E£C<uc tndex>] JEANNE OFFLINE 
“\- (<uc index>] CARLYE ONLINE 
“e- 7 LOGGED CN 
Examolte 2: #£4z(List the currently “online” terminals.) 
Input: --- .LIST TERMINALS 


Reply: --- ‘Lersn>] <SPO> <v.isn> Aa aA 
: me- (<rsn>] <lsn> <v.etsn> Ab DA 


@#eaeoeoe#e2ee?te¢eeee @ 


: LIST . 


 @e0eanedenenaecean | 
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eg ss | Operational Guide TAS bettas 


SLIST ‘Ccontinued) 


i «i anasallt nn Timcmdiitemntins.calliosasdiinmndiiceedtttencadiianentinnacatitznnatiasnanstittieadiieadndtiteass! 


ere ae en com (co Ae ON ni wen cai ie ID ORD eae ei em ae 


Example 3: (list alt “file transfers “scheduled” to. occur.) 
“Inputs =-- .LEsT SCHEDULE 


Reply: === SCHEDULE List. ‘NOT TMPLEMENTED 
a se — Cenumber>sccount>] 


Notes?” < ae." the above: Skieple Viste: are Ate abaved in 


reverse. order. on the SPO untess the MCP option 
"DIRN* is set to the value "1". 


2. Example 1» the "<uc index>" is Usercode Index. 


~—_ LIST . 
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Function: — This €oenand is a shorthand version of the "CUPY" 


command and is used to specify exolicit file "PUT" 
transfer requests. The command syntax provides for 

transferring files “from™ the tnittating system to 
another system (Ca PUT). The files can be either 
magnetic tape or disk Cin any combination) and the 
onty restricttons that aoptly are those identitfted 
in Section Il. “Restrictions” 


Syntax: @PUT <file-name-1> ( CUSER=<usercode-1>> --------> 
---> PASSWORD=<password-12) }  s-77sceeene-e----- > 
we-> CAS <file name-2> {(USER=<usercode-2>» “<--> 


ONTO 


T77> PASSRORD=<password-2>) 1 1 oe 


a . . Ratan se ; 
com> CFROM Cé<volume-1>) _ [ “CKIND= PACK ) 117 ==> 
| . TAPE ay 

TAPE? 

TAPED 

PETAPE 


ee=> (TO. {<volume-2>] (C(. CKIND= PACK ) 1) 2 
| — TAPE yee 
TAPE? 
TAPES 
PETAPE 


Note: Tf a "usercode™ is not desired as a multifile-id to 
| the file name on the receivirg system» then prefix 
"file-namer1l" with an asterisk “*#". 7 


@#e2e3aeaee#esee2eeeet @ 


e PUT e 


~ gie0ossi790 SYSTEMS: COMMUNICATIONS: NODULE 


— Section Tin Commands 


PUT (continued) 


opp CU CRIN OE OR EN A ee Oe oom 
| SD A I CRE A EE pe see se ee 


Defaults: . 
Options: | 
Exaaple L: 
Staputt Me 
“Reply: === 


Example 2:. 
‘Input: 


Reply: 


= Notes; 


(Software Oper ationat Guide 


‘esas satiate: see 
ee eum ee 


Sand. the progran "TESTL6" to the Server 
execution.) = 


“Original. “version? 


Refer to the "Copy= command semantics. 
Refer to the “COPY” command defaults. 


ae command options. 


System for | 


PUT TEST 16 


FILE ‘TESTI6 START ‘TRANSMISSICN. 


FILE TEST16 END 


“(Send a printer-backup file to the hub" 


i Le . 


“SPUT* file transfer » 


 peverse circuagstancese. 


TRANSMISSION 


system.) — 


.PUT csP007#2121 


FILE (SP0)/#2121 START. TRANSMISSION 
FILE se END ee 


In the ah a implement ation. for. file transfers 
froa either tape or disk to tape in a receiving 


systems if a scratch tape is not mounted and/or 


ready» SYCOM will “*hang" until the tape is made 


available? no notification is made of this 


condition and no input messages/commands are | 
processed. — | | [ 7 | | 


Upon comptetion of the 
the following message 1s 
displayed on the SPO of the “other® system: . 


Referring to example 13 


% SYCOM =<job #> FILE TEST16 RECEIVED 


This is also true under the 


: PUT . 
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Function: — This command is vatid from any source. Once the 


Statement is enteredse the “usercode/password” is 
stored, without validation. This data ts forwarded 
to the other system for "CONNECT" commands and is 
used for fite transfer purposess as the default. 
usercode/password when none is specified. | 


‘Syntax: - .USLER] <usercode>/<password> % 

Semantics: . Wispricgte 2 predefined user identification. 
ieeswone. = a predefined user security code. 

Default: | None. 

cecal” | (Log7an to SYCOM.) 


Input? --- .US MY/USER 


Reply: -"~ USER MY/USER LOGGED ON 


Note? a If a “usercode"/"password” is atready. logged-on»p 
| the current log-on attempt is stilt attowed and 
takes precedence. | 7 


@eeenee eeoeaeenvre 208 e@ 


. : USER Pr 


e@2eoenne2eee2 0208 0 @ 
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ee mee a ae mee 
a A A wee et 


Function: 


Syntax: 


Semantics: 


Default: | 


Example 1: 


Inputs --- 


Section ur Comnands or 


COriginat Version) — 


The WHAT cowaand solicits the return of a Ponty 
message indicating the current "status” of SYCOM's 


processing activity. The reply. message is vartabte 


in length and content to reflect as many conditions 
as possible. If. any fifle is in the process of - 
“transfer"» its name and the number of records thus 


| var transferred is disolayed. 


WHAT) 2 


 Nonee 


Example 23 
Input: - 


Reply: - 


Note? 


None: | 


(Assume. at the ‘tine this command is entereds SYCOM 
as connected and waiting for something to do.) 


WHAT. 


SYCOM ONLINE? TOLE | -, 
THIS STATION OFFLINE> LOCAL Kost “USERI- 
REMOTE HOST + SERVERL | 


sad wile la entered during a file transfer.) 
e WHAT 


sycoe ONLINES 00 FILES QUEUVEDS 


SENDING: DMPALL(70/82)# NOT RECEIVING 


fas Mosk ae a WHAT reply ts extremely fluid in. 
that it is representative of what is happening at 


the time the command is entered. Because of the — 


ss number of combinations of events that could be in 


progress at any given times it is not feasible to | 
attempt to example them alt. Howevers the exaapisis: 


above will give the user some 
¥dea as to what can be expected. 


 @eeeeseeneanenea: 
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Section III Commands Oo | | “4 (Original Version) 


*<SeCS Command String> ‘(User System) 


moan men ene a an eam erm nem mam ee eee ee 


Function: 


Syntax: 


Semantics: 


Default: 


Example: 
Input: <<«- 


Reply: --- 


ee ee ee ee ee 
we ee ee etm ce RR ee AN Oe eh a ome ee ee soe a mee coe 


This command syntax allows a terminal user on the 
User System to give commands to the system's SMCS 
for processing. Commands entered from a terminat 


that are prefixed with a sigrat character of **" 


are intercepted by the Network Controller and are 
immediately sent to the SMCS for orocessing. 
Consequently» the entire rance of SMCS commands are 
available to a SYCOM user with this command syntax. 


*<SMCS command> {<attributes>] % 


S¥CS command = any SMCS command which is valid from 
4 | a User System terminal. 


attributes = any data elements that are required. 
| cy the command syntax. 


None. 


“*FILE (JEANNE) /GUIDE, 


‘(JEANNE )/GUIDE® IS A PUBLIC FILE OF 
188 RECORDS (90 BYTES» 29 PER BLOCK) IN 


10 BLOCKS (10 PER AREA» 1 AREA) CREATED ON 


 Note?. 


O4/24/78>» LAST ACCESSED ON 
N6/21/7B CACCESS SECURITY IN INPUT- -OUTPUT) : 


AND CURRENTLY IN USE BY 0 USERS 


For a complete List and descriptions of the SMCS 


7 commands available, refer toa the "SMCS Software 


Operationat Guide™. 


a ee ee ee ee a a er er er 
- ee . ° 
e *<command> .- 
o . e 


eeeaeoann0nn en 02 00 @ 
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Section IIT Commands a _  COriginal Version) — 


2) <SMCS/MCP Ccawand Strings’ ‘(Wser System) 


ee nadie nadine diitae tina. td ee scsi a ib sista ete is “abe ao Sia ty Wey Slike ack aha sg? ol aa 2a 
AE OE OD EE EN OND AMD ND AD GENS ED OUND AE SUT SERS fem GUND AR: ee SOS am me cae en Mowe alte, SNe Ae wom ek vie meme ae see mek cee swt nee ae ee 


Function: This command is used to give “safe” MCP commands to. 
Oo The User System's MCP for processing. This command 
string is message Switched to the system's SMCS by > 
the Network Controtler which in turn “zips® the. ; 
command string to the MCP fer processing. The SHCS 
appends an appropriate usercodes passwords and. 
session number to the messace *if™ the user is 
currently "Logged-on" to the SMCSs otherwise the . 
command Bees O08 ‘String is EyEeS as entered. | 


| Syntax: 8 <XX> cacp dommand attributes> 4 


it 


any MCP command which is 


Semantics: XX - 
7 valid from a work station. 


t 


mcp command sialic any data Gieeenes: eaaeea. 
_ | ay: the command Sy Ouse. 


“Default: None. 


Exanple: 
“Input: --- «2 PD =/= 


PD= eer | 
PD= ae ee 
PD= "“4DUMP" 

POs "PROGRAKX™ 

END POD 


Reply: --- 


Notes: | Le) «The "mcep command string” is made secures that 
. | —_ is» in the above examples only the user's 
directory is returned. 


2 e Refer to “Appendix Fe Restricted MCP Command | 
Summary" for a list of those MCP commands which. 
are permitted from a terminate. eg fi 


 @eCeeeeeneneaece . 
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<x><SMCS Commanc Sncaas (Server system) 


ec ae OR ON A wk ce EN oD ae RE OR OI GOED GD cn OO em Gee eee eth om. wees 
Ce ne ee ee ee ee ee ee ee ee) 


Function: This commana syntax atlows a terminat user on the 
ae - - User System to give commands ta the Server System's . 
S¥CS for processing. Each command entered must te 
prefixed with the current signal character for that 
SMCS* wt must be different than that of. the User 
System's SMCS for obvious reasons. Alt messages 
with this signal character are intercepted by the 
Network Controller ana immediately sant ta the SMCS 
fer processing. Consequenttys» the entire range of 
SMCS commands are available to a SYCOCM user. (This: 
ccmmand is only valid when a SMCS is running in the 
server system.) : : | 


Syntax: — - €x><SMCS command> C(<attritutes>] % 


Semantics: as : = the Server System's current SMCS 
| | _ 2 "signal character”. | 


~SeCS commana any SMCS command which is valid from 

| a Ce pene PePEvnes: 

attributes = any data elements that are required 
- : ty the command Syntax. | 


Default: None. 


Example: | 
Input: --- SFILE (JEANNE) /GUIDE 


Reply: --7 "CJEANNE)/GUIDE® IS A PUBLIC FILE OF 
a 188 RECORDS (90 BYTES» 20 PER BLOCK) IN. 
7 oa C10 PER AREA» 1 AREA) CREATED ON 
—6 O44 24/78 LAST ACCESSED ON 
NG/21/78- CACCESS SECURITY IN. INPUT- -QUTPUT) 
ANO CURRENTLY IN USE BY 90 USERS. 


Note: | In the above examples the "$$" 


character is assumed to be the : - Bete. AP 

Server System's SMCS "signal | a rea ee eee 
character". | | a ee ee geet 
| _ a e <x><command> . 


ee eeeeraecesen eee 


eee SYSTEMS ‘COMMUNICATIONS MODULE. ae az Seo eae 


OE awetion ur Commands oy ae Coriginal ies 


ae, <SHCS/NCP Command String> (Server System) 


>_* ss cas <a ‘cea cs eas tgs * oi ss" cn eis St sn a Sal st es ee i i i inti: ou has sii ssa ps Seals <a oe Satta i 


SO EE De AO AES ANTS ON END OD SES GE RE NE SED ARE SE oN Sie cee Seb Ne aN SD Oe ome eh thet Ante tte celine Unt een AON tm Gam, wtlim sD same A CO a ND aD ae ae 


Function: This command foridat atlows: certain MCP commands. to 
be sent to a Server System for processing. They are — 


” “pepmitted froa either the User. ‘System's SPO. or fron 


one of its terminals. All replies to these commands 


are returned to the User Systen. SYCOM which causes. 


them to be displayed on a appropriate spO/terminal., 


Certain MCP commands require a “usercode/password"> 


prefixed to the desired MCP commands which is known 


to the Server. System. To do these commands however» 
- requires the. SMCS operating in the Server System. 
See “Appendix. F" for the tist of safe MCP commands | 
for oa B1800/81700 Server System. Alt comaands that 
require a userecde/passwore are so indicated. | 


Syntax? : | aT eee Re ema 
meme> CXX> <meD command ¢ attribute s> a: 
Semantics: 6% = the Server System's SuCS 


signal character. 


XX. | 7 ae = any MCP command code or. 
| Ph Wg job # that would be valid. 
| eae a berarnat or SPQ. 


u 


any data elements. required 


- @cp command attributes 
| | es 7 by the command. syntax. 


Default: | ——- None. 


Example: (Request a "PD" List for user currently logged-on.) 
— Input: <= $2 PD =/= | | 
Reply: --=) POS "TESTER" 
oo " — PD= "GQPENS*™ 
END PD 


Note: = ~—s«s In the above examples the "$" «ss wwecccccccccce — 
ne ee eae character is assumed to be the = .« © = © « 


Server System*s ‘Sucs "signal kar) KOR SKK 0 a 
ee Chanactenns | | Poe ee 3, Te A ge eae ae ee 


‘ a 2 eae ‘@ ee @e ee a2 ee e. io . ie 7 
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System SPO/Program Commands 


The following SYCGM commands are restricted to entry from either | 
the system S°0 or a special application program. These commands 
are generatly of the type used by a system operator to control 
functions celevant only to operation of the system. They are | 
generally functions a terminal user cannot logically direct _ 
“without current knowledge as to the state cf the system and its 
peripherats. 8y enforcing this restriction, the system is assured 
that control is at the system level. and not at a terminal tevel. 


Program command input does not require the command string to be 
prefixed with SYCOM's “jot number* and an "AX". Command input 
from a program should be in the same format as command input from 
terminals. an | | 
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toe. 


Function: — 


ae “Software ‘Operational Guide — | 4 mi ets: “Page er re 


The eCL command is. used. to “clear” a peripherat 
device in the event the. device becomes inoperable. 
when receiving. a data file. It clears (discards) 


the buffers associated with the specified device. 
_ and the receiving process is terminated. 


Syntax: 


Semantics: 


‘Default: 


Example 1:— 


Input: --- 


“Reply: --- 


Example 2% 


Input: --°- . 


Reoly: <«-=- 


Notes: 


‘enck <udi> % 


uci = ene unit Bovies Pdentitiee. is restricted to 


one of the following mnemonic. codes? 


i we petnnee 


uP 
| Card Punch 


CP 


not 


None: 


(Clear the Line printer because its down.) 


<sycom job #> AX.CL LP 


—Gno response) Ee 


Celeste che aed punch because there is” no need to 


sep EHnUCE ss 
<sycom job > AXs cL cp 


(no response) 


None. | 


@e@ ese ennenneace 
— @ Bo fe 


at is - - | CL. e 


See eeeeeenen ene | 
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CP 


ide 


 Furction: 


Syntax: 
Semantics: | 
Default: 


Examptes. 


Input: 7<- 


Reply: - 


Notes: 


The purpose of this command 1s to tnform the User 


System that the systems Card Punch has fatten into 
a "not ready" state. SYCQOM ir turn informs the 
Server System Cif such connection is established) 


of this hardware deficiency condition. The Server 


system would “suspend” transmitting any card punch 
data strean messages? lf it was in this. Process. 


It is a nespensiullity o f the User Systea, saseneer. 


to inform SYCOM (via the apcropriate command) when 
the card punch 15 again “reacy” to receive aUees 


(see notes below). 


 efP NR & 
NR = Not Ready 
Non@e 


Cinfora sycoM that the Card. Punch “is not ready.) 
 ésycom job #> AX.CP NR 


(no response) 


1. To intorm SYCOM that the "card punch” is now 
ready to receive out put détar the "RY cP" 1s5_ 
provided. | | 


a if. the card punch has beccme "inoperative™> 


then the ".SV CP" command is more appropriate. 


wm ener eeaneeawanee |) 


Section een Commands: 


Ao, A AT NS SOY ee 


Function: | 


Software Operational Guide 


—— ar800zex700 5: SYSTEMS, “COMMUNICATIONS: MODULE 


“Ae. “sep” 1978 


See 


“Coriginal, Version) 


the, "DEBUG" ‘edweand provides the facit ities’ for. a. 


a printer trace of alt data messages read or written” 


bby SYCOM. 
printer tracings 
tracings 


and when no. option. 


The "ON* option will initiate the. DERUG © 
the "OFF" option will terminate cee 
is specified a peaueee 


for the current status of the DEBUG ree ety: is. 
| <a sraets : | | | 


Syntax? 


Semantics: 


— Default: 


Example 1: 


Input: alice 


Reply: 


Inputs soe 


Repl y f o<= 
Example 33 


Input: 


. “Replys === 


Notes? 


DEBUG <default option> % 
ON | st oe 


OFF 


sohrteaes 


If no otto: is. epacitied or the. option is invalid» 


<sycom job #> AX.DEBUG ON 


% SYCOM =<job #> CEBUG TURNEC ON 


‘CObtain current DEBUG status.) 
<sycom job #5 AX DEBUG 


= -% SYCOM =<job #> DEBUG ON 


(Turn debugging OFF.) 


<sycom job #> AX.sDEBUG OFF 


Noneae 


‘% SYCOM =<job #> DEBUG TURNED OFF 


Cnot ON or OFF) a “status request” is apsuse ds. 


(Turn printer debugging “ON" for all 1/0 messages.) 


 @seeaeenne ene 


 @eeeeonseen00 i ©. 


DEBUG . 
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Function: The ".—OJ" command prevides the capability for an 


orderly shutdown of SYCOM. Any further commands — 
are prevented (by rejection) from being processed. 
A message ("PLEASE SIGN OFF") 1s broadcast to att 
terminals currently “logged-cor”™ to SYCOM. A “close 
message” 16 sent to the other system*'s SYCOM after 
the comptetion of any intoprocess file teansfers and. 
when there are no longer any terminals signed-on to 
SYCOM. The SYCOM orogram then sends a “disconnect 
message™ to the Network Contrcller. and goes to © 
"end“of-joh™. | | : | 


Syntax: -EQS 2 


Semantics: | None to specify. 
Default: None. 
Example: (Entering the command to shutcown SYCOM.) 


Input: --- <sycom job f> AX.EDJ 


Reply: --- % SYCOM =<job #> PLEASE SIGN CFF. 
“--- % SYCOM =<job 4> E0J INAITIATEC 
“-- % SYCOM =<job #> SYCOM NOW CFFLINE 


Note: | _.. ALL file transfers which are scheduled to occur 
| ~§€queued) are permitted to trarspire. | 


*eo 2a ©0268 @ 82806207 @ 


@ e 


« “2% “EOS. 


@eneceeeovreeeeenne | 
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Section 29 & Comeands as | ; a | Coriginat Version) 


, comtdiiesaaiiikerene thas madiietnand , 
re ane seb ome mm 


Functions — 


This command. is wee froa. any Reveinal or. the. spo. 
“Its purpose is to display information about the 


system and its users. Command options provide lists 


of current system "parameters"» users currently 7 
"“signed-on"s terminals that are currently "ontine» 


and file transfers currently “scheduled” to occur. 


Syntax: 


Semantics: | 


De fault: 


Example 1: 


ROME? abn e 


“Reply: wee 


PARAMETERS 


TERMINALS — 


SCHEDULE 


NMNN HNN NW KR 


woe PARAMETERS co 


USERS 
“TERMINALS 
SCHESULE:, 


requests a list. ae the parameters 
SYCOM is. currently leat with. 


ee 


‘¢équests a list of alt users J eurcently 
“signed=o nm to SYCOM. 


ies 


requests a list of att terminals. that 
are currently “online”. 


requests a List. of all file transfers | 
ad scheduled. 


7 currentty thi is no defautt.. 


(oisptay the: vers of SYCOM's parameters.) 


_<sycom job: #3 AX.IsT PARAMETERS 


SYCOM =<j6t > TERMINAL RECORD SIZE | 189 
SYCOM =<job #> DEBUGGING OFF 


SYCOM =<job #> PROGRAM. INPUT =  —- ALLOWED 
SYCOM =<job #> FILE TRANSFER = © ALLOWED 
SYCOM =<job #> FILE SEPARATORS = = = — SENT 

SYCOM =<job #> MAXIMUM BUFFER SIZE. 400 

SYCOM =<job #> WAIT FALSE. 
SYCGM =<job #> TIMEOUT INTERVAL | 25 7 
SYCOM =<job #> SYSTEMID _ ne "USERL Eee 


won 


ee ee ee eee | 


i a? WEST 


| @ a eweeveneseeeece 
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LIST Keoneenuees 


ee ee ee 
ee wren ets en eee em ee 


Example 2: 


Input: °*- 


Replys cen) 


Example 33 


| Input: oe 


Replys c-- | 


Example 4: — 


Inputs --- 


Reoty: --- 


Notes: 


wm er re. 


> me we ow 
— = 2. 


(List the current signed-on users of the system.) 


<sycom job #> AX.LIST USERS 


SYCOM =<job #> C<uc index>] DENNIS ONLINE | 
SYCOM =<job #> (C<uc index>] JEANNE OFFLINE 
SYCGM =<job #> E<uc index>] CARL YE DNUTNE 
SYCGM =<job &> 3 LOGGED CN 

coves the currently “onl ine* terminals.) 
<sycom jot #> AX. LIST TERMINALS 


% SYCOM =<jok #> Cersn>) <SPO> <veisn> Aa aa 


—% SYCOM =<job #> (€<rsn>] <tsn> <v.lsn> Ab BA 
” sycoM =<job #> 2 TERMINALS IN USE 


(list ala file transfers "scheduled to occur.) 


<sycom job > AXoLIST. SCHEDULE 


-% SYCOM =<job > SCHEDULE LIST NOT IMPLEMENTED 


U<number>/<count> 1 


1. The above example lists are disptayed. in | | 
reverse order on the SPC unless the MCP. operon 
"DIRN™ is set to the value "1". 


ON 
es |. 


Example 2s the "<uc index>* 1s Usercode Index. 


_. @@ @@8@88702648060080 


esas 9 Operational 


Section 11 ‘Commands | 


12. ‘sep. 


Guide oan 


a the purpose ot ‘this ceeuada: ‘is to display” counts Of... 
specific: data communication line errors and certain 
message transmission Statistics. — 


These counter are > 
"not" zeroed. out after. they are displayed. 


~~ effect is. produced when these. counters Cidentifiers. 


Syntax?) 


Semantics: 


Default: 


— Exaapler. 


Input: - 


 Notez — 


‘ included) are printed 
Cif the DEBUG mpEioD was wanree§ 


of” SYCOM =<job #> TIMEOUT = 


in the "DEBUG trace" 


Sia: 


None. 
_ None. 


(Request a di sotay of the ‘status counters.) 


”  egycon: job. BP AX. Loc. 


<ccunt>, 
BREAK = <count>» | : 
- END@= OF- BUFFER = <count>» — 
LOSS“QF “DSR = ScOunte 
Loss- en A ia <count>.s | 
PARITY = <caunt>»s ag t 3 
BUFFER OVERFLOW = <count>» 
MEMORY PARITY = <count>s — 
- NUMBER OF TRANSMISSIONS = 


Se. a <count>» 
 . NUMBER OF ne SENT = 


<number>. — 


Expect the dbave aaty message to be. displayed as a ou 
single message string. 7 — 


lL eee een wav e2eee 


1978 
Cpa 


“Coriginat, Version) 


The tog. 


Ae 
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oLP 

Function: The purpose of this command is to inform the User 


System SYCOM that the line grinter has become “not 
ready”. SYCO¥ in turn tnforms the Server System of 
this temporary condition. The Server System then 
suspends transmitting of the line printer data 
stream messages until notifiec to resume by the 
User System*s SYCOM. | | : | 


It is the responsibility of the User Systems 
operator to inform SYCOM wher the line printer 1s 
again ready to receive output data (see notes). 


‘Syntaet.. LP NR 2 
ceaantie NRO= Not Ready 
Default: — : None. 
Exanpte: ~ (inform SYCOM of a “not ready" Line Printer.) 


Inputs **- <sycom jot #> AX.LP NR 


Reply: --- (no response) 


Notes: _ i. To inform SYCOM when the Line printer is ready 
a a to accept output data» the ".RY LP™ Command is 
provided. | _ 3 


2e If the tine orinter has become “inoperative™» 
then the command ".SV LP" is more appropriate. 


3- This command is only retevant to KJE functions. 
In particulars when the line printer is tn use 
printing a RJE printer tackup file. 


® ; s 


* 3 EP 2° 


eaetresneaeneees 8ee 


Function: | 


“p1e00/si700° SYSTEMS COMMUNICATIONS rr 
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Section III Commands 


 LOFFLINE 


Oe de 
SE ED RE AD RN ate, eae are 


Syntax: 


Semantics: 
Default: 


Example: 


Input? --- 


Reply: -o= 


Notes: 


sep. 1976 


Coriginat Version) 


The purpose of the ” OFFLINE" command. is to inform — 


a Server Systema that the User System is going to. 
"break" the existing connecticn and go into standby 
modes waiting for the Server System to catl back. | 

This command can 
"non-switched" line connection. 
Controller actualty performs this action (upon 


be used for either a “switched” or 
Since the Network 


SYCOM directive)» it then continuously monitors the 
"data set ready™ signal. When this signal comes 7 
"“true"» the Network Controller re-establishes the | 
connection with the et ard normal Bpeeeuens 
then resume. * | es . 


eOFFLENE 2% 


None. 


None. 


Leaves jot “> AX. OFFLINE 


%~ SYCOM =<] bb #> OFFLINE INITIATED 
a SYCOM =<job #> SYCOM NOW OFFLINE 


Nonee 


; : @e2eeaeseoeeonneeeaneee 


- OFFLINE « 


ree eee ee se 2 ee 
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~ SONLINE (establishment) 


mn te sam oh ae am on am om an ae 
— a ew gp RR ee a «Pr ee am 


Function: 


on wh 0m a Oe ab oe om ee OR 
a ae em re cam A EP OR ee 


The ouroos e@ of this command 1s to cause the Network | 


Controller to attempt to re-establish the line a 
connection to the Server System. Upon satisfactory — 


completion of this tasks a response Pes a9¢ 1S 
displayed (see example below). | | 


This command may be used in ecniuneeion: with the 


retry function. The error message "RETRIES“UP" is 


Syntax: 
Semantics: . 
Default: 


Examples | 


REG: em 


Reoly: --- 


Notes: — 


disolayed when the current message huffer being 


sent to the Server System is rot being received. 


By entering this command» the message tuffer being 
sent is discarded and an attennt is wade to re- 


establish the line connecttior. 


eCNLINE 


None. 


None. 


(<sycon job > AX- ONLINE 


% SYCOM =<job #> ".ONLINE® cecpenen. Oe 
% SYCOM =<job #> SYCOM NOW ONLINE to REMOTE HOST. 


— None. 


eoneeereannean neve 


- ONLINE « 


eee neon een? eeees Bice oie | 


ae eA | i‘ aL 1 8 00 / 8 1 7 0 0 s Y s Te “ s ‘ on M “ U Nt | nteATE t 0 NS Hoo uL E We ‘sep Pp 1 19 7 78 : oe 
software. Operational Guide 


Section 3 IIT Commands 


PHONE 


. ae wen ONE te wt nme 


A ED CUD NED awe Heme 


Functions 


Syntax? | 


Semantics: — 


The PHONE command i 
phone number 


Page 4 


is used to sither westablish™ a 
‘to be used for the dial-out to the _ 
predefined Server System or to display an existing 
number. The automatic diat-out Cwith an ‘Auto Call | 


Unit) to. a specific Server System requires a phone 
numbers hence the need for the omens 


i ~ PHONE ‘<phond. huaber > i, 


<null | Option 


phone number 2 ‘the | hone: nueber: of a target Server me é 


a iar: 


a mit ention = ‘no option specified. 


Default: 


ee Gee clears existing phone numbers 


The. oaieston. “be a vwatia sien number in the: owasne oe 
string causes any existing phone peepee previous) 


“att entered to. be "displayed". 


Exampletiz 


eee 


ieee. ° 


es an autordial unit ws Supa eds 
phone number is used the next time dial-out is 


‘(establish bie. dite diat phone nuaber of. a specific 
Server Systems) 7 = 4 | 7 | 


<sycom job s AX. PHONE 1-805- 564-6881 


bie response) 


‘the ‘specified 


initiated to establish a connection to. a Server 
System. (CDial-out is autowaticalty : initiated by 


the "ONLINE™ command.) 


ls @ Oe eeneeveaeene  — . 


PHONE 


COoriginat Version) 
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Functton: | 


syntax: 


Semantics: 


 pDefault: 


Examples: 
Input: --- 


Reply: --- 


Note: . 


This command allows a user to set a maximum number 


of message tuffers that can te queued at any one 


time between SYCQMM and the Network Controller. The 
value range for this parameter is 4 thru 15. (for a 


description on the use of this parameter see the 
writeup on “Queue Depth Control™ in Section I1.) 


-9S=<queue size> 2%. 


queue size = a 1 or 2 digit integer representing 
the new Queue Dercth Limit. A suggested 
value for this parameter. mere be 10 | 
eae sae purer a 7 


None. 


(Change the queue size to 10.) 


<sycom job #> AX.QS=10 


% SYCOM =<job #> QUEUE SIZE CHANGED TO 10 


ok soacitied value outside the defined yatue range - 


produces an error Peep cuaes 


een @maoneaeee828 


e . . 


eonevneaeses ee 08 0 
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eREAD 
Function: ‘The ” READ" command causes SYCOM to open an input 


card file and commence transmitting those card data: 
l@ages to the Server Systems providing a connection 
has been established. When end-of-fitle ‘is reached» 
the pee: is closed par oe eve mar ye 


This eoumane: is. only processed when ‘the User syster 
3s property lagged-on to a Server System which is. 
defined as a "host". (It is possible to override 
this searure by using the ".RYCR* command instead. ) 


Syntax: :. miele 

‘Semantics: NGnGs: 

“Default: Assumes the ey rer file is ltabeted "RJE/CARDS". 
eres 7 “Gstart transmission of an RJE card data file.) 


Input: ---  <sycon job #> AX.READ 


Reply: ---  % SYCOM =<jab #> CARD READER OPENED 
io --= % SYCOM aby > CARD READER CLOSED 


Note: An input cat’. file is defined to be any group ot 

a | ecards with the first card in the deck containing. 
"<I> STREAM. RJE/CARDS*® and the last card conta yaad 
"<J> TERMINATE RJE/CARDS". (The <I> symbol 
represents an invalid character in column 1 as 
required for MCP control. 


oe READ 


Seeseoeensereveee 


81800781700 SYSTEMS COMMUNICATIUNS MODULE = =  =———-'12 Sep 1978 


Software Operational Guide : Page = 102 
Section III Commands | Oo | | — (Original Version) 
-RY (ready) 
Function: | This commang is used to infors SYCOM that the 
| oe specified perioheral device its currently ready to 
send/receive data. SYCOM in turn takes the 
appropriate action to advise the Server System. 
Syntax: RY <udi> % 
Semantics:  udi = the Unit Oevice Identifier is restricted to 
a 3 | . one of the followtng mnemonic codes: 
CR = Card Reager 
Cp = Card Purch 
LP = Line Printer 
De fault: There are no cefaults. 
Example: = (Ready the Line printer.) 


Input: “== <sycom job #> AX.RY LP 


Repty:s --- (no response) 


Notes: — | None. 


ean eneeanneenea eee 


a  o? Re >. 


_ ma eeesrnaneenveee  - 


Function: — 


“Syntax: 


Semantics: | 


‘Default: 


Examples 


Input: --- 


Replys a= 


 SSTZE=<buf fer size> me 


/—— atecoveiz00 s SYSTEMS “COMMUNICATIONS Ss MODULE 12 Sep pire 
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This command allows the systes operator to set the- 
maximum message buffer size fcr transmitting and _ 
- receiving purposes. SYCNOM then informs the Server 
— System of. this change | with a specrat ete control Pac 
z type. Beery | : : 


- buffer size-@ i is a three digit integer with a cevae: 


limited to a rarge. o f from "078" theu 
— 4008) a : | | 


None. — 


“¢Reduce the send/receive message block buffer size 
co to 320 characters.) : 


<sycon job > AX SIZE= 320 


% SYCOM =<job ‘> "SIZE" INITIATED 


this eoedant. ‘Wplies only to the RJE functions of: 


the on systems 


ee eeeneceneeeeon. lt 


a re @2eeoe228.9 8 es es hay tae 
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i 
Hi 


Function: 


Syntax: 
7 Semantics: 
Default: 


Example: 
Input: -°- 


Reply: --- 


Page - 105 


(Original version) 


This command provides the ability for an immediate 
shutdown of SYCOM. No further input messages are 
accepted as SYCOM goes to “encrof~jot” immediately. 


Terminats are not togged-off» virtual terminals are 


not disconnected» nor is an inter~system connection 
gracefully disconnected. : | 


~ STOP Oo 


Nonee 


(Entering the 


<sycom job #> 


% SYCOM =<job 


% SYCOM =<job 


None to. specify. 


immediate shutdcwn command. ) 
AX. STOP 


#> STOP INITIATED 
#> SYCOM NOW CFFLINE 


e@eeoeneeasneneeeon 


‘Software Operational Guide — “= es {gs Page PIT: 


a Sect ion IIT Commands -? a wh oe eee Version 


ton. 
Hoe 


fhe 


Function: — 


entire file at. the Server System. The command | 


 permanentty inhibits the trarsmission of as 


until notified by the User yates (see notes). 


Syntax: 


Semantics? 


Defaults: 


Examples 
Input: --- 


; ‘Reply? ~-- 


Notes: 


2SV <udi> 2 


of the. eS Omen ah mnemonic codes: 


cP 
LP 


Card Purch 
Line Printer 


th 


None. 


(Terminate the output to the Card Punch.) — 
<sycom job f> AX. ‘SV cP 


(no responsé) | 


1. To re- -edbabtish the card SHEE or line sea nter™ 


output data streams the command ".RY CP" (for. 


-——--BLBOO/B1700 SYSTEMS COMMUNICATIONS er nt, 42. Sep 1978 
This command directs the User System to inform the. 


Server System to cease transmitting the card punch 
or line printer data stream and to "save" the 


further card punch or tine printer data streams 


udi = the Unit Device Identifier is Limited to one | 


the card punch) or "RY LP* (for the printer) | 
must be. used. This is used to infora the Server 


System to. $start sending any card punch or tine 
printer: data streams that are available for. | 
transmission. 


2. ALL card bunch and line printer data streams 


Start at the pees, of the file. | 


= * > SV 


0200800000007 8 


a 


® 
a 


oe 
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7; a rr ha ! Local System 1 Remote System 1 
[rr . 3 © Be 2 Input | 1 Process —s | 
{ | | USES ee Re Se Se a ee a eee ae eee ee 
i Command ' No SMCS § SMCS 1 Source 1! No SMCS # SMCS 1 
Jonene cen mmm mena ¢ os ewenane tonne a Soleetatenatel Sealataltetatetel totetetetated 
i ae j i } t 1 1 
{ eABORT | yes tyes i TSP off no i no § 
[ =6.BYE ; yes tyes t JSP 4 no tno 1 
tf .cL | { yes ' yes % SP i =ono i no j 
1 .CONNECT | { yes ! yes 14 TSP ‘ no i no 1 
i .caPyY | i yes tyes & SP. 1 no ft no 3 
i = .CP | yes lt yes Ut SP i ono tno { 
1 .DEBLG { yes tyes | sp no [ no i 
f eDISCONNECT { yes ! yes 1! TSP og no { no { 
Pb .EOU i yes lyes | SP oJ no. tno | 
[ .FETCH i yes tyes ! TSP 1 yes tyes 1 
i .LIST ' yes tyes tt TSP { no 1 no ( 
( LOG { yes ft yes J] SF i no - ! no { 
§ .kP 1 yes ! yes |! SP { no ' no { 
( OFFLINE 1 yes toyes f SP ' = =6no tf no ft. 
t  .ONLINE { yes tyes SP ! no tno 
i PHONE 1 yes ft yes | ‘SPU. no. i no 1 
i PUT i yes ft yes { TSP 1. no tno 4 
' 495 i yes I yes ! SP i no t no i 
! eREAD f yes { yes i SP { no i no 1 
1 RY i yes tyes | SP i - no { no i 
| eSIZE 1 yes f yes 1 SP i no i no i 
' .SsTrop { yes tyes 1 sP. ff no - t no { 
1 .SV i yes tyes 3 SF : no ' no ( 
{ .USER i yes tyes t TSF i no i no i 
! oWHAT i yes 1 yes } TSP I no ! no { 
| «<User SMCS> t ro it yes 1% TSP { ono ! no 1 
1 *?<User MCP> { no f yes ¢ TSP 1 no [| no 1 
i <X><Server S¥CS> 1! no l no ! TSP § no 4 yes 1% 
1 <X>?<Server sCP> 1 no ino ! TSP ot no tyes 1 
1 | -— i { { ie : 3 { 


Notes The above commands are restricted ec entry from the source — 
| eC aee in the table above. od 


Legend: T = Terminat 
Saeco SS = SPO 
 P = Program 


— Table IlI-1: Command Input Summary — 


SECTION IV 


OD G0 OR een a OE pu CE ce ~OR w ae ern ae gene er) ame qe <P ER Oe Em GER eee a ome GEER seyT em Cer GED ewe wee CR re ee ON owe qu Dee RE ee RE ORK RD me CE com nome ee wee een 
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SECTION IV 


«OPERATING PROCECURES 


Aw teaDUCTT ON 


we a ee 2m an Om a ee ee ee ee 
— 6un ee ee Dee ee ee 


This sectton pro cvides system ana terminal operating procedures 
used for the operation of a SYCOM system with and without local 
terminals, and/cr in conjunction with the Supervisory Message 
Control System (S¥CS). System operating procedures are slanted 
toward operation of SYCOM for the purpose of Remote Job Entry. 

(CR JED type functions and the associated system control functions. 
These procedures present all aspects of SYCOM operations fron 
initiatization thru contrctted shutdown. 


Local terminal operational procedures are separated into two (2) 
categoriess terminals under SYCOM control ard terminals under the 
controt of the SMCS. These procedures provide coverage of alt 
terminal operations within the scooe of SYCCM) from sign-on to 
~—signwoff. Actual input/output message text is used tn the_ 
examples to provide a feel for the ease of aperation and what can. 
be i by a user of the SYSLems 


SYSTEM OPERATING PROCEDURES 


> se om a ae P ame cur 2 «eR Gow ED CGF -ene SRP ce om oon GER ww oO ee om ae mR wr om 
<> Ger GED Gm Gee <GP ame cur ee cre <8 ED OD -eP OR CGD a ae “Re eee GFP Ree OR ER wR ee 


The system ‘operational procedures presented here are intended to 

provide a User System operator with sufficient information for 

operation of an interactive system using SYCOM. Operation of the 
associated Network Controller is briefly discussed. In addition. 
suggestions on the use of certain hasic SYfC™M commands and their 

options: are a 7 
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pneuaarnane PROCEDURES: 


‘Adee the’ sycor eu Stes 1s ‘éxecuted> ‘the. user needs. to nya aware 


of, a few system variables that must be considered. First there 


are "“orogram switches” which are used to invoke certain optional : | 
features. Second there is the "parameters" file which is used to 
maintain SYCOM's variable. control functions and processing as | 

attributes. — Each of these subjects in covered in turn starting: 
with the proscee switches. . : 


ti sland bbe 


hepeoeeae: Sui ten. 2 serves tua ‘purposes: 1) if "set to the value of 
m2" at execute tiges the initialization phase causes a display» 
on. the SPO» of SYCOM®s "compile time and date"s else no display. , 

2) If the switch is "set" after BOJ times then the purpose is to 

cause any excess Length I/0 DEBUG trace lires to be truncated. to 
. exactly. one print. cane to reduce DEM elnae ar the DEBUG be ae = 
“fset™: of ‘Course. . | : 


\peocrak Switch 3 serves to “expand the inforsation message that 1s 
displayed at initialization time with a current "run date” (both 


time and date). Because this switch is used in conjunction with | 
Program Switch 2» it must.atso be. "set" prior to Steen execution tn 


time for switch 3 to be effective. 


“Preparation of Parameters. tard File 


-. Because SYCOM iebneniaadtai uses an existing "parameters™ fite 
from disk» to enter changes to any existing file requires that. 
the current SYCOM/PARAMETERS™ file be removed prior to program 

execution. This causes SYCOM to effect the process which creates 
a new parameters file based ons 1) a predetermined set of defautt 

parameters and 2) any parameters entered supersede, the associated 
detault, Paraecuens : 


Th ese. oaeaamcoee can be ere either. ai the ‘card noadee! or | 
the SPQ. | However» an impcrtant point to notes SYCOM will first” 


attempt to accept parameters from a “card®* file. and. failing. to 


find this files enters the mode whereby it. accepts parameters 


from the system SPQ.. Theretores if card parameter input is. to. 0 
Oey ae card reader “must be readied” Peis (to ‘execution, 
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A simple way to create a parameters file is to punch a card deck? 
providing the target system has a card reacer tn its hardware 
configuration. The external name of this parameters card file is 
“CARDS. Foltowing is. an example of a SYCOM system card file: 
(The <I> in the example below represents an “invalia”™ character 
as required for MCP type commands.) | : | *, * 


<I> DATA CAROS. 
3 DEBUG © 
BUFFER 4Q0 
~~ RECORD 240 
SYSTEMID = USER1. 
PRFPOGRAN 
NOFS 
NOFTP 
WAIT. 
TIMEOUTS = 25 
<I> END 


The above example shows “ali™ of the available “SYCOM parameters. 
Howevers in areal life situations parameters are selected to fit 
the requirements of the individual system. Refer to the procedure 
"Entering the Parameters” of descriptions of these parameters. 


If the. system. does not have a card reader> then the procedure | 
"Entering The Parameters" must be utilized “after™ SYCOM has heen 
executed. When SYCOM is ready to accent parameters from the SPO 
it 1s sc tndicatec ty the display of "ENTER sy¥co™M PARANETERS™. 
(Refer to "Execution of - SYCOM™ Beg Coes e Sao 


ee MCP Program Name Table 


In order for SYCOMs Network Controller to ce ‘automatically 
executed by the systems» tt is necessary te establish the identity 
of this Controller in the "MCP Program Name Table. To do this is 
(Simple e» enter the following MCP command: —_ 


“=> CNC USER/NCCetx) | —_ 
NETWORK CCNTROLLER CHANGED FROM "=" TC "USER/NC® 


The controller name "SY COM/NC™ is of course a user optional name 
and 1% therefore cnly representative. The actuat Controtler name 
 ~setlected by the user would be aus tituted as required. 
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To. ver ify Wak? the poneedt Nat work Panteol tee: I/D 1s in “the: MCP | 
Name Table ea the following MCP command can be entered: 


ee> WHCCetx) | 
| C = "USER/NC™ 


Assigning Program Priorities 


For optimum system responses it is necessary that the System's — 


Network Controtler and SYCOM run at a “high” priority. Therefores 


to ensure that the HCP automatically executes these programs at. 


their optimum prioritiess the following MCP commands are used to 
permanently assign a priority of "15" to the Network Controtter | 
and a pEVOEuCY: of "12" to SYCOM: 3 | " | 


aes HO-USER/NC PR ines 
 SUSER/NC™ MODIFIED | 


--> MO SYCOM PR 12(etx) 
: "SYCOM™ MODIFIED 


EXECUTION OF sYcoM «= witout SMCS 


oe re re eee een ean ne ebb ee aawee 


To use ce SYCOM system alt houe the Ganetit of a SMC So oWhe evareey 


— operator simply enters the execute SYCOM coamand as shown below. 


The MCP automatically executes the associated Network Controttler 
program (providing one is in the "C" stot of the MCP Name Table) 


when the first remote file open is initiated for the controller. 


- Both SYCOM and the Network Controller should be run at a priority 
which ensure adequate response times to the user of the a 
(see sugdes tee DEVONVEY values below). , 


It is the option of the user whether or not SYCOM is executed 
with a “privileged usercode". If accessing of usercode files is 
-reauireds then it must be executed "with" a orivileged usercode; 
otherwise execute SYCOM as shown below: : ree re 


© tema JX SYCOMCetK) 


sone SYCOM =< job #> 800. PP= 12> MP= 12 TIME = 08:14:51.2 
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During the beginning of the initializatior chase if SYCOM cannot 
locate the “SYCOM/PARAMETERS” file on disks it attempts to obtain. 
new parameters from the card reader ("CARDS" file). Should the 
card reader be “not ready” or if there is ro card readerer then 
SYCOM will Lapse into the mode of acceptine new parameters from 
the SPO. When SYCOM is in this mood, the fcllowina messages are 
displayed on the SPO: | a | 


-% SYCOM =<job #> ENTER SYCOM PARAMETERS 
SYCOM =<job #> ACCEPT. 


The system operator can then enter the appropriate parameters to 
alter the system's “default parameters” (refer to Appendix. Ge 
"Parameters File Attributes"). The entry procedure is presented 
with “Entering The Parameters” in this section. Although the 
"SYSTEMID® parameter is not required» in some instances» it is 
strongly suggested that a representative “system. identifier be 
entered with the parameters at this time. 


Once this file is established on disk» it reed not te recreated 
untess it is lost or requires changes. Changes to the file can 


made using either of the two methods identified. However» againe 


1t is necessary to "remove”™ the existing parameters file from. 
disk. <Addittonally» this requires SYCOM tc be shutdown and 
rerexecuted if it 1s currently runnings else all is in order. 


When SYCOM cpens its Remote Files» the MCP knows whether or not a. a 


Network Controtler is running and takes the appropriate action.. 
That iss if a Cortroller is runnina> then the remote file opens | 
take place and the system hecomes operational. If a Controller is 
not” currently runnings then 1f the Contrclter's name is in the 
ee. stot of the MCP Program Name Taktes the MCP automatically 7 
executes the named Controller program and the following weseege 
are eennaeee at ae SPO: 


EX SYCOM/NC PTS eo ee 
— SYCOM/NC =<job #> B0J. PP=15» MP=15 TIME = 08:15:08.7 — 


If there is no Controttler name entered in the MCP Prograe Name 
Table» then the fellowing message is fe des a 


REMOTE FILE "MCSREMOTE™ NEEDS A CONTROLLER 
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he. evecea. ‘operator gust: then’ execute: the appropriate Network | 


rt by eters the. following | command? 


EX SYCOM/NCCetKD 


= SYCON/NC. =<job > adJ. PP 15> MP= 15 TIME ere 


“The MCP eitetaed the abower “‘wBoue messager permits the Reaote. Fite 


7 opens: to occur and the system is Gpetet won ste. 


“Further on during the initialization phase» if Program Switch oo. 
is set to a value of "2"» the following Seso2ge': is displayed on 
the aes ‘SPO: _ | | Se. Si gta. «pd? * Ge 


x eon a DATE = FREDAY 24 JUL 78 AT 12:07 


ong Prochae Switch 3 is set to a value of a3", ‘then the following 


message is also. displayed in conjunction with me: above (messages 


fn ORT = SATURDAY 19 906 78-9 L085 


Upon oun teeicn of SYCON*S | wag eialivarion hase and a Ssuckeestal. 
connection established to a default Server. Systeme the following 
.. messages wilt be disptayed on the User. SPOs eb ek, 


7 SYCON “ejb "> ahd: ‘SYcoM (O7 724778 12: 08) kee 


z SYCOM =<job #> SYCOM NOW ONLINE TO REMOTE HOST = aide 


EXECUTION OF SYCOM « WITH SNCS 


Oo ee neem semen nen emo aaa me 


When SYCOM runs in conjunction with the SMCS» it is sivenatiaatiy 
executed by SMCS thru its "job spawning" facility. This occurs 
when the "first" terminal user "SIGNS-ON" or “PASS*s*” to SYCOM. 


from a local terminal. Therefores the systew operator must not | 
execute SYCOM from the system SPO; else SNCS just zip executes 


another: copy. of SYCOM unscn causes a mem operationat problems. — 
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If during the initialization phase» SYCO cannot tocate the file 
WSYCOM/PARAMETERS"» it attempts to obtain new parameters from the 
card reader C"CAROS"™ file). Should this card file not be oresent 
or if there is no card readers then SYCOM commences to accept new 
parameters input from the SPO. ~ To signal the system operator of 
this requirement. the following messages are a 


x SsYCcOM =<job #> ENTER SYCOM PARAMETERS: 
SYCOM =<jot #> ACCEPT. 


The system operator ase then enter the appropriate paeweetors to 
override the system*s "default parameters" (refer to Appendix Gp» 
"Parameters File Attributes"). The parameter entry procedure is 
presented with “tntering The Parameters™s this section. Although 
the parameter “SYSTEMID” (ts ne onuined: for some instances» it 
is strongly suggested that a representative “system identifier™ 
be entered with the parameters at this time. | | | 


Also during the initialization phase» if Frogram Switch 2 is set 
to the value “2"» than the following SPO message is displayed: 


-% SYCOM =<job #> COMPILE DATE = FRICAY 24 JUL 78 AT 12:07 


If Program Switch 3 is set to a vatue of "3"» then the following 
message 1s atso disptayed in conjunction with the atove message: 


RUN DAY = SATURDAY 19 AUG 78 at 19:13 


Upan completion of initialization and the successfut connection 
to a default Server Systems» the fotlowtng messages are displayed 
on the tser SPO: 3 | 7 | 


xk sycom =<job #> s#ee* SYCOM (O7/24/78 12298) eeee 
% SYCOM =<job #> SYCOM NOW ONLINE TC REMOTE HOST = SERVERI 
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COMMON SYSTEM OPERATIONS: 


Once SYCOM. has” hace axle Gute ida either the SPO or spawned by. 
‘the SMCS» most operating procedures are. common to both modes of 
operat ion. These common operating procedures are oriented to SPO 
input in the form of SYCOM parameters» SYCOM commands» and MCP | 
directives. Following then are the common cperating proceduress 
presented in the sequence they are most cnety to occurs SHOaae, a 
individual headings. | | 


SMCS Signal Characters 


Ram Ob UM a 4) OR Oe wD 8 OE a Oe ae em ee 


In order for a SYCOM systems network to furction effectively» it 


is a requirement that the SMCS “signal character" for each system 


in the network to be a different character. This can be easily 
accomplished by mutual agreement when the SYCOM system network is 
designed. Each system's SMCS should have a specific character 
which is made known to all System users. (Cbhviously» if the SMCS 

is not utitizeds this is not necessary. | : ; 


If during actuat system operations it is found that a SMCS signat 
character is undesirable for. any reasons it can be changed white 
online. This can be accomplished by entering a “signat character 


- change command” from etther a tocat or remote source. For. actual 


detail se refer to the "SMCS. Software Operational Guide® 


Entering the Parameters 


The parameter definitions listed below can be entered to SYCOM 
from the system SPO. To do so» they must be entered with one 
tine ustag the fottoutng. "Accept" process: 


2-> ad cad! job #> aX <parameter keyword> (= <value>] : oo 
7 US Deraeerer keyword> {= <valuer less] Cetx) 


‘Each paraaeter is padabed: and the syster cperator is inforaed’ 


of any illegal parameters encountered during the parsing of the 
yoabamen ge Coes | | | | | 
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DEBLG parameter. 


This parameter. ndveseus’ chat the printer tracing gachanise is. to. 
be utilized to produce. a record of sveons 1/9 See aaae activity. 


Syntax:  CEBUG 


The default for this parameter is no “printer trace”. 


BUFFER parameter 


This parameter cefines the sizes in bytes» of the used in SYCOM 
communications with the other system. The tuffer size should te 
larcge enough to handte the largest message» and ut ad achieve 
a blocking: factor for multiples of a record. ie 


Syntax: BUFFER = <integer> 


The default buffer size is 400 and the maxigum allowable. size is 
19590 bytes. (This parameter directly relates to file transfer 
buffer size and not RJE buffer size. y | 


RECORD parameter 


This saneweter defines the maximum record size. This value Limits 
the record size of files» and the length cf program-to-program 
messages transmitted by SYCOM to another system. Thus» if SYCOM 
is to he used to transfer code files ee the record size could | 
be set to 1@0 bytes. | | | i 


Syntax: RECORD = <integer> 


The default recerd size is set to the wate of 180. The maximum ~ 


7 record size permitted is 1959 bytes. 


i 


gt eoorsizoo SYSTEMS: COMMUNICATIONS woe 12 ‘sep piss 
Software: Oper at ional. Guide a Page at eee 


| Section 1 ‘Operating Procedures ; ote “Original Versions 


stereo paraneter 


“This San aeecer is used to. spect fy the name of. the: User rrr eee 


: i a vets 4 can be. coaprised of fron one to. seventeen characters. — . 


ee ee ee <systea-id> hae daa 


PROGRAM paraneter 


this parameter as. speci fidd: hen SYCOM. is to enone see erau=to- 


 SYCOM functions. The “record size" parameter limits the maximun | 
— tength of these Bene Agseo75 | SO 7 i a 


ee PROGRAM. 


This parameter defaults to “no” program-to-SYCOM input permitted. 


| Timeauts parameter 


aera parameter is used to, establish an "interval" for the diaplay. 
of “NUMBER OF TIMEQUTS = 25® error messages on the system SPO. A 


 eaken of "0" inhibits eho: massage display entirely. Other. values 


cause the message to te displayed when the timeout count: reaches: . 


. the spacitied WRENS: 


“Syntax: TIMEOUTS = <number> 


WAIT parameter 


This parameter is. ere to. prevent sycom from going ees 


when it receives. a "disconnect message”. eo will. pvecounect 
and ane into a “offline/idle”™ state. 


Syntax: WAIT 
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NOFS parameter 


sycom will not send a "ESI" or “FS2" Cfile separator) to the 
eae system when sending card images (relevant to 7.9 RJE). 


Syntax: NOF S 


NOFIP parameter 


This parameter inhibits Fite Transfers. 


Syntax: . NOFTP 


E TX parameter 


Damen annana a we 


Entering an ETX in the parameter string terginates the parameter. 
input process. 3 | 3 


Syntax: <sycom job &#> AX <parameter string> Cetx) 


: SYCOM Commands fro# The als 


The system operator is permitted to communicate Aven SYCOM using 
the MCP "AX"™ facility. By entering certair commands Cexamples 
below)» the operator is also permitted to communicate with 
application procrams in a Server Systems thru the “virtual | 
terminal” facility of SYCOM. <A typical command session might go 
as followss SPO input is flagged with pee: 12NG indented lines 
are output repky messages? | | 


=> <sycom job #> AX WHAT Cetx). 
% SYCOM =<job #> SYCOM ONLINE? IDLE | . oa 
-% SYCOM =<job #> THIS STATION OFFLINE» LOCAL HOST = USER1L 
| REMOTE HOST = SERVERI pee 
-=> <sycom job #> AX.PUT OMPALL (etx) 


“% SYCOM =<job #> FILE DMPALL START TRANSMISSION 
— % SYCOM =<job #> FILE DMPALL END TRANSMISSION 
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ae "> <sycom jot #> AXe CONNECT Cetx) 
ok SYCOM ejob #> ".CONNECT® INITIATED. 
--> <sycon job #> AXEX ‘DMPALLZFI quTF. FILE INV 2cetx) 


X% SYCOM =<job #> OMPALL =<job #> BCJ. PP=9-5 MP=9 TIME. aoe 
% SYCOM =<job #> % OMPALL =<job #> ENTER SPECS 
‘% SYCON =<job #> OMPALL =<job #> ACCEPT. — 


--> <sycom job #> AX<dmpall job #>AXCOPY OSKLST SHCS/TRACE 
-_ io 120, etx) | 


SYCOM =<job #> OMPALL =<job #> “oUTPUT@ = "BACKUP.PRI/11 
SYCOM =<job #> DMPALL =<job #> "BACKUP.PRI/1L1" RELEASED 
~SYCOM =<job #> 2% DMPALL =<job #> ENTER SPECS 

Shack =<job #> DMPALL ae > ne | 


NNR NN 


=> <sycom job #> AXCotK) 
—& SYCOM =<jot #> DNPALL =<job, #> EQS. TIME 1 = 12235255.6 
 we> csycom job #> AX.OISCONNECTCetx) : | 


— % SYCOM =<job #> STATION DISCONNECTED 


7n>  <sycom job #> AX. FETCH BACKUP. PRI/ULCetK) 


«4 $YcoM =<job #> FILE BACKUP.PRT/11 START TRANSMISSION. 
- % SYCOM =<job #> FILE BACKUP.PRT/11 RECEIVED 
% 


—SYCOM =<job #> FILE BACKUP.PRT/11 END TRANSMISSION 


“systematic ‘sYCoe Shutdown’ 


When SYCOM 15 running as - dei¢-sustaining antity cute heue: the 
~SMCS)>5 the *.£E0JU" command provides the means by which an orderly 
shutdown can occur. Once this command has been entered» all 
subsequent cosmands entered are rejected. An appropriate "close. 
message" is sent to the other SYCOM after the completion of atl. 


- in-process file transfers. SYCOM then sends a “disconnect _ 


message" to the Network Controller and goes to "end-of-job"™. To 
initiate an orderty shutdown of TOM: the system operator must _ 
enter the following: ns : a 


os>  <sycom job #> AX.EOJCetx) 
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The following message is displayed immediately on the User SPO. 
— % SYCOM =<jok #> EGS INITIATED 


No further processing requests are accepted. Any file transfers 
queued to orocess are altowed to complete. At the point in time 
when there is no tcnger any SYCUM activity» SYCOM goes to "ENJ". 
The standard MCP "E£0J message” is. displayed for this action: 


—SYCOM =<job #> EOJ. TIME = 16:21:55.1 


When SYCOM is running in a self-sustaining environment and it is 
necessary to shutdown the system "“immediately™» then the ".STOP” 
command provides this means for termination. Upon entry of this 
commands ail in-process activity is aborted and all scheduled 
events are purged. A “close message” is then sent to the other. 
SYCOMs a "disconnect message” sent to the Network Controllers and 
the program goes to “end-of-johb". The system operator enters the. 
following to eoEilees Ae: immediate shutdown of SYCOM: 3 


ose>  <sycom job #> AX.STOPCetx) 
the following eReader ee then disptayed on the system SPO: 


x SYCOM =<job #> STOP INITIATED. 
3 YCOM seer 4> EOJ- TIME = a él: 55. 1 


When SYCOM is running in conjunction with the SMCS» the "*STOP* 
command entered ta the SMCS in turn causes SYCOM to be terminated 
automatically. When this occurss the follcwing message will be | 
displayed on the SPO: | | , 7 


—SYCUM =<job #> DEATH IN FAMILY. TIME 12:58:91.1, 


A note of importance: If there are any requests queued for 
processings they are se when SYCOM# shuts. aqown uncer these 
circumstances. | 7 


w 
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 goace toasty. Hints” vend: Pointers ~ 


= (em ewe ee osm em ewe emmn ew eeesewn 


oy During. ee. course of SYCOM ‘aperations» there are ‘a few unusual. 
system “conditions” which could occur. In order for the. system 


operator. to correctly respond to these conditions» there must be 
sufficient information available. That information is provided 


here in the form of problem. descriptions» "hints". "spointers™s 


_ and responses. to these conditions. | 


Oo Wan BE at any. ‘time ‘syédu. appears to 7 “hun g-up" > a *ejob re 
WY command must be entered at the acer SPO. at the. 
a message. is disptayed: | | 


SYCOM =<job > WAITING MAGNETIC TAPE, <tape labet> eo 


tear has on automatically stopped geitine:. coe. ‘the: oe 
required magnetic tape to become availables at which = 
time SY¥COM. operations witt automatically resume. _ 


This Sondixicn is ‘desolved. by the operator. ‘aaking. a 
scratch magnetic tape available te the system. 


— brought down with a MCP "QC* commande CA. system includes 


the SMCS» Network Controllers CANDEs and atl Beogrees 
_ associated with the Network Controtter.) ee a i. 


af the. following message 1s displayed: 
| “SYCOM =<job_ > ‘EXECUTING 


rd SYCOM has juae: ben executeds then the Ge oblee: lies” 


in the fact that. SYCOM is atteapting to establish a ioe iy 


connection to thé remote system. It will continue this” 
cycte until the. édhnection is made or the program is 
DS'de Nc input Commands. will be entertained “dur tng. this 
initial establishment cycle. } 


8. If ‘the following message is. Peet er eT ‘ey the MCP) on a 
- e system SPQ during the initialization Pubs a 


INSUFFICIENT DISK WHILE OPENING QueuE- FILE msycomm 


be means that. here: is not. reuthicnene space. on. ‘disk to. mo 

open the “SYCOM/LINK.Q* queue. Affirmat ive action by the 

system operator would be to make available a sufficient. 
amount of disk space Sanarextmaxety aoe aaaeentey<: | 
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TERMINAL P@QCEDLRES 


In this sub-sections basic terminal operating procedures are 
provided in the form of examples. For a-SYCOM ortented system 
however» terminals may te owned by either SYCOM or the SMCS. _ 
Because of these possibilities and the asscciated implications» | 
specific operating procedures are included for both "SYCOM 
controlled” and “SMCS controtted” terminals. 


TERMINAL FUNCTIONS | 


ieeanal: functions are those software features found na 10829, 
and/or 10830 type Video Display Terminal (VOT) devices. These 
‘terminat features would included such thinas ass tab. stops» 
lower/upper cases scrollings etc... These functions are fully 
described in the Supervisory Message Contret System (SMCS) 
Software Operational Guide (see documentation reference). 


TERMINAL OPERATIGNS (SYCOM CONTROLLED) 


When a local terminal is under the direct centrol of SYCOM» it is 
also permanently “attached” to it. Therefore» a terminal user has 
immediate access to SYCOM functions. A terminal can howevere be — 
temporaridiy “attached” to either SYCOQM or the SMCS in a Server 
System. Thru Server System*s SMCS» the terminal can also be | 
“attached” to an appropriate interactive aprelication program in. 
the Server System. The terminat user is not limited to just a 
few SMCS commands» a user may invoke any cosmand which the SMCS 
has in its repertoires with the exception cf those restricted to. 
input from the spc. | | | 


Example Interactive Terainal Session 


Terminals at this point are attached to the User System's SYCOM. 
In order to utilize the SYCOM capabilities» a terminal user need 
only enter the cesitred SYCNM commands. Among these SYCOM commands 
are “.CONNECT” and “.DISCONNECT". These are used to gain access 
to any appropriate interactive application program in the Server 
Systeme The examples. which follow exptore att possible terainal 
connections as cetailed in "Message Path Assignments”. 
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aa Se seaeptes belows terminal input is identified ie the ‘flag - 
Att other lines are reply messages from the progran. to 
whack. the terminal is currently inputting to. First some basic 


local SYCOM commands are shown. Atl SYCOM commands are entered 
directly as exagoled below: | eee, a eteped By, PER 8 ee Gee 


ee> WHAT ser S¥COMD 
- SYCGM ONLINES IDLE | ee 3 
THIS STATION OFFLINE> LOCAL HOST = USERI 
-REMCTE HOST = SERVERI re gt ie oe 
--> .PUT DMPALL a User SYCOM) 
FILE CNPALL START TRANSMISSION 
--> WHAT - ot se _* (User SYCOM) 


SYCGM ONLINE> 00 FILES QUEUEDS SENDING DMPALLC47/85)° 
THIS STATION. OF FLINES LOCAL HOST = USER1>» | 

REMCTE HOST = SERVERL. | - 

ETEe DMP ALL END TRANSMITSSEON 


(o2> CONNECT 7 . os Beg (User. SYCOM) 
"CONNECT? INITIATED | | ee a ees 
=> WHAT ee re | (User SYCOM) — 


SYCON ONLINE? IDLE. | | — 
THIS svarron BNLINES LOCAL HOST = USERIs 
REMOTE HOST = SERVERL -_ 


ee soss - SS (Server SMCS) 


ACTIVE: | * - 
SERVERS NC =<job- 4> PP=15» MP=15 
SMCS =<job #> PP=13» MP=14 
SERVER/SYCOM =< job. #> PP=12» MP=12 
SCHEDULED: 

BOTH SCHEDULES EMPTY. 

MIX LIMIT= ae 


ae is. necessary ‘hae: ‘the erin user be aware of hee “‘eei anal” 
character™ the Server System's SMCS is currently using. To find 
outs the Fopcou ng command is entered to query that character: a. 

SIGNAL ee xP (Server sMcs) 


“SIGNAL, CHARACTER="5— 
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Now the terminal. user can “sign on” to an application: prograr mn 


the Server System? and alternately enter commands to the Server — 
System's. SMCS. A series of following interactions exemplify this 


concept: (The application program “SET/TABS” used in the example 


15 assumed to “set® specified tab stops in the user® s terminal.) 


SIGNEC ON TO *SET/TABS*» SIGNAL=*8? 
Bi aciad $y08s , & ar oe ? “ | - CServer SMCS) — 
7 ACTIVE: : oe 
— SERVER/NC =< job t> PP=155 MP=15 0. 
SET/TABS =< job A> PP=he MP=4 
SMCS =<job #> PP=135 MP=13__ 
SCHEDULED: _ 


BOTH SCHEDULES: EMPTY. 
MIX LCIMIT=16. 


--> 104207300406 50060070 Sever APD 


(tab stops are now set) a : ees ee 
REMCTE FILE CLOSED BY *SET/TAGS*» STATION SIGNED OFF 
o> EX OMPALLSFL QUIP.FILE INV 2 =. —— (Server SMCS) 
 -DMPALL =<job #> BOJ. PP=9, MP=9 TIME = 11235:21.2 
%Z OFPALL =<jobe #&> ENTER SPECS | | EL 
DMPALL =<job #> ACCEPT. 
ne> <dmpatt job #> ‘AX COPY DSKLST SMCS/TRACE, 120 9 


2 DHPALL =<job #> ENTER SPECS. 
DMPALL =<jot #> ACCEPT. — 


“=> <dapalt job #> AX | 
 DMPALL =<job > EQS. TIME = 11236258... 
At the point in time when a user is finished entering commands to 
SYCOM and wishes to terminate the session, the following coamand 
is entered; however» the terminal is still "attached" to SYCOM. 
=. -DISCCNNECT ee oe (User sYCOMD 


| STATION DISCONNECTED 
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© TERATNAL OPERATIONS (SNCS CONTROLLED) 


Le, gene vereinat: is. permanently attached to and pad: bys: ‘the. 
SMCS» the. terminal user must. gain access to SYCOM. functions thru | 


_ the use of explicit SMCS commands. These commands are. exampled 
‘below. By gaining access to SYCOMs the SMCS will temporarily. | 
"attach" the requesting terminal to SYCOM for the duration of a | 
session. However» a terminal user is not timited to just a few — 
SMCS commands» a user may invoke any commaro which the SMCS has” 
in its repertoire; with the eRCSDE TON: of these restricted to | 
eee from the ie oe : | | | | . 


‘Susans Interactive Teratnat. Session: 


- ah Cee wee emt eee ee eee es ewe eee mem oen Ce 


See t6palnal a ed ded Seeiaeie esa User System's SNCS. | 


In order to gain access to those nifty SYCOM capabilities,» the 


terminal user must make use of the SMCS "SIGN ON" and “SIGN OFF" — 
commands. The sagple session which folloxs» shows the. terminal | 


user just how. easy it is to. "get on™ and "cet of f*. SYCOM? Cinous, 
“es the terainal is. identified by the flag ie ie | 


ee “SIGN CN sycom | a User SHES) 


“SIGKED ON TO Be ale 


+ nen: the "signed-on™ nessdda. i SoeGened: to the ‘<erpiaats that. 
ss terminat is then attached to. SYCOM. There fores ~SYCOM commands 
are entered directly as. exdapled below: = wR es 


"> .WHAT - te | a (User SYCOMD 


SYCOM ONLINES IDLE ae a 
THIS STATION OFFLINE» LOCAL HOST = USER1 

- REMCTE HOST = SERVERL a | 

t->) .PUT DMPALL 7 res re - User SYCOMD 


FILE DMPALL. START. TRANSMISSION: 


5 a> WHAT i - - - | - aan user sycony 


—SYCCM. ONLINE$ 00 FILES QUEUVED? SENDING DMP ALLC47 785) 
THIS STATION OFFLINES LOCAL HOST = USERI» 
REMOTE HOST = SERVERD 2 9 | 
Thal OMPALL | END. TRANSMISSION 
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--> .CONNECT) 2 (User SYCOM) 


 MSCCNNECT™ INITIATED 
-->  SWHAT oo 7. 8 (User SYCOM) 
| “SYCCM ONLINES IDLE 


THIS STATION CNLINE> LOCAL HOST = USER1. ~ 
REMOTE HOST = SERVERI ee 


--> *REPORT > 2) Oot _ 7, * 3 “(User SMCS) 
>DL (SPO) = SIGNED ON TG *SYCOM® a 
L STATION REPORTED AT 11242.6 CE/22/76 
--> JOBS oe . es, | (server SMCS) 
ACTIVE: 


SERVER/NC =<job #> PP=15»5 MP=15 

SMCS =<job #> PP=13> MP=14 a at 
— SERVER/SYCOM =<job #> PP=125 MP=12. 

-SCHEDLLED: | . 4 e 
_ BOTH SCHEDULES EMPTY. — 
MIX LIMIT=16 


It is necessary that the SMCS in a Server System have a “signal. 
character™ that is different than that: of the SMCS in the User 
System. To ensure this» the following command its entered to | 
query that signal character: (CIf it "is not" differents then 
change its “SIGNAL $".) 7 | a ee oe | 


2-> SIGNAL  —s—s—ssS Server SHES) 
SIGNAL CHARACTER="$* 

Now the terminal user can “sign on” to an application program in. 
the Server Systems and alternately enter commands to the Server — 
System's SMCS. A series of following interactions exemplify this 
concept: (The application program “SET/TAG8S" used tn the examotle 
1s assumed to “set" specified tab stops in the user's terminal.) _ 
aS SIGN GN SET/TABS. _ | _ 7 (Server SMCS) 


SIGNED ON TU *SET/TABS*» SIGNAL=°"3° 
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“7> $4088 ar ie oe: | Server SMCS) _ 


ACTIVE: 3 | 
SERVER/NC =<job. #> PP=155 MP= 1S 


SERVER/SYCOM =<job_ #> PP=12» MP= 12 
SET/TABS =<job &>. PP=4» MP=4 _ 
SMCS =<job #> PP= 13, MP=13 

SCHEDULED: 7 

~~ BOTH. SCHEDULES ENPTy.- 
MIX LIMIT=16 


=> #REPORT > a ; | | (User SMCS) 


ny! (SPO) ¢ SIGNED ON TO” rere 
1 STATION REPORTED AT ‘1L:64.2 08/22/78 


ae 10 5205 30% 40450660470 | a | a =_—en 


er stops are ‘now set) | | 
REMCTE FILE CLOSED BY ‘SET/TABS* >» STATION SIGNED OFF 


~">  . DEBUG oa. a ore -Cuser SYCOM) 
ss DEBUG OFF = . 
ug «DISCONNECT , | : ; 3 | CUser SYCOM 


STATION DISCONNECTED 


At the peat in ttme iene a. User is Cini ches snter ine commands. to 
SYCOM and wishes to terminate the sessions the following soemenc 
is entered: (This is a SMCS command.) 


77> *SIGN OFF 7 . 4 ey 7 (User SMCS) 
The response from the SMCS Will be as follows: 
“DETACHED FROM ‘*SYCOM® 


At this points the terminal has been “detached” from SYCOM and is 
one “re-attached" to the SMCS. | : mae ._  < 


SECTION V 


am am a) =e ap om om ae oe ae ate ee oD GE ame a8 OEP OOD ~eR CED ae aw ome 88 ame 28 OP om OP Or OP ee ew we ae Oe OR Ge a om Pe OR om ew ae «eo a aw 
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SECTION Vv 


_ GENERATING THE, NETWORK CONTROLLERS 


= a aoe wae eee waie | ban aaa ewons one ceeeee < a2 enn eae wm me 


GENERAL 


‘ome am yee wee wn em ae 


This section is eouided 4s a user Srecnted quidetine ‘to ener | 
| generation. of a Network Controtter for the SYCOM systew. — The 
controller is generated by. the Network Definition Language (NOL) . 
_ coapiler using a prepared set of NOL specifications. The systea 
user is required to determine these NDL specifications according) 
= to the system configuration. and environment under which Rue 

7 Network Controtler. is to function. 


The. fovioaias aupdelines: rT btiered for a ance! Syecen piste. is. 
to provide the full range. of SYCOM services, including terminals. 


‘They are intended to aid the. user in generating a Network 


Controller with correct functional | attributes. For a coaplete 


description of the NOL specifications and definitions» refer to” 


the "Network Definition Language : noterenes manual" Cassociated | 


_. documentation). 


DETERMINING THE SPECIFICATIONS 


UD cn Oke SOR Om Se OE cm eee wee ene cary enn sme cele Toney wee <a we Some = ine <P ee 
TO AE SOR AE OD OED OED Ont ER cH Re EE aR ee ee ee ee ee ee ee en ee eee een cree ree een 


“The fotlouing saaple Network Controlier. NOL ‘speci fications are 
presented in a sequence similar to that of the NDL reference 
anual. This allows the user a logical reference for evaluating 
the sample NDL specifications for application to the. instatlation 


 - pequirements. They identify suggested parameters which produce — 


-. an operational Network Controller ‘program for the /S¥COM aye oe a 
eon ah aes as. “specified. — a ci oe 
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OPERATIONAL PROCEDURES 


—- we sem am CO OE em me GTR GD ee CEP ae OR fC eR ee OE a. eam «ae 
RN EP am ee ER Oe wee ee DO he SER iw “te EP ee Cee RE ee eee co 


The following orocedures provide the methods by which the user 
prepares the input to the NOL comptlatton process» generates a - 
Network Controller» and induces modi ficatrons into the resident 
NOL compilers if required. | | oe 


Preparation of Input 


The NDL “source™ input file can he prepared in the form of either 
a card file or a NOL type disk file. The cisk file could be 
created and maintained using CANDE or another text poster of 
‘similar capabilities. | 


The “Sample NOL Parameters File* is furnished for the purpose of | 
creating this file with the most amount of accuracy in the least _ 

amount of time. Any adjustments to this scurce file for number of 
lines» terminalse and other such attributes is the responsibility 
of the user which is attuned to the System confiquration and its. 

operational | environment. : 7 


Compilation Process 


Prior to voaviatine the NOL eompeteewan Prcecesse the user should. 
‘ensure the presence of a "7.9 NOL/LIBRASY* file on disk» of a 
07/24/78 or tater vintaged. Thene there are several methods by 
which the NOL compilation (generative) process can te invoked. | 
Following are two of these methods: | | | 


1. Card Input: 


Following is a seieieive example cf a NOL source eerd 
input deck: (The <I> tn the example betow represents an 
rinvalsd™ character as required by the MCP. ) 


“<I> CO_USER/NC NCL LI 
<I> DATA CARDS 


NOL source images 
“NDL library calls 


—<2> END 
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(2. Disk Input: 


This method is used to initiate a NDL compiler process. 
when the source input file resides. on disk.’ ‘Enter ‘the: 
following NCP command using the system SPOs 


- > 6 User AOL LIFE hos aay anne sounce 9 DEF 


From this point one the Seubidovien Bp ieacuves: are the sage. when | 
the MCP executes the NOL compiler» a normal "B0J" message is 


_ displayed. Upon successful completion of the compiles the normat a 
"EON" message 1s displayed. Howevers if an error message such as 


the Boke omnay ae disptayed?: 


NOL “USER/NC =<job #> =-EVALUATION/PROGRAM POINTER STACK 
: 7 OVERFLOW DS BR oP | 


Then ‘the: preecaure "NDL Compiler Hodi fications” must be utilized 
to fix the. problem. | 


NDL Compiler side 


Should the NDL eoapitatien. peat hecause of a lack of sufficient. 
internal work spaces the following procedure can be invoked to 
expand | the NOL peepee: itself to overcome the problem: 


-*=> EX SDL/SSCCetx) | ? 
SDL/SSC =<job #¢> Bod. PR=4 TIME = O07: 28: 48. L | | 

~ &% SDL/SSC =<job #> SDL/SSC> MAR K VIT.0 OF LO¢21/77 21: 19 
% SOL/SSC =<job #> 7 

—% SOL/SSC =<job #> ENTER FILENAME OF BLANK TO TERMINATE 
SOL/SSC =<fob > ACCEPT. bs | | ie; a 


as aeebee job #>AXNDLCetx) = 
—% SDL/SSC =<job #> *#eee FILE NAME = NOL 

z SDL/SSC =<job #> ENTER SCRATCHPAD KUMBER 
‘SDL/SSC =<job #> ACCEPT. 


s=>  <sdl/sse job #>AX0Cetx) © 
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% SDL/SSC =<job #> | 7 | 7 
% SOL/SSC =<jfob #> sanaeex SCRATCHPAL: 0 
 -£ SOL/SSC =<job #> VALUE = 27000 | 
2% SDUL/SSC =<job.4> NAME = 2090 | 
% SOL/SSC =<job #> DISPLAY : 192 — 
z% SOL/SSC =<job #> CONTROL 2: 40 | 
2% SOL/SSC =<job #> EVALUATION 3: 40 
Z SOL/SSC =<job #> PROGRAM POINTER =: 59 
Z SPL/SSC =<job #> DYNAMIC = 29000 | “ 
% SDOL/SSC:=<job #> saeanx TOTAL CORE: 63112 
Z SOL/SSC =<job #> ENTER STACK Io, 
“SOL/SSC as t> ACCEPT. | 


The value "300" used in the example below is a known acceptable 
integers a smaller value may also suffice but would be dependent. 
upon the size and complexity of the Network Controller being 


— generated. 


--> <sdl/sse job. #>AXE s0NCetK) 


'y% SDL/SSC =<job #> ENTER * * TO ENC CHANGES 
SOLZSSC =<job #> ACCEPT. es 


--> csdl/sse pers #>AX Cetx) 
ae updated List ‘of program parameters is displayed). 


SDL/SSC =<job #> EQS. TIME = 07:29:50.6 


If any other error messages are displayed along this veins they 
should contain sufficient information to allow the modification | 
of the associated program parameters in the manner shown above. 


Print The USER/ACNIF File 


nae’ ne souns Uakson7daneretion: of the Network Contrulice. is. 
completes it is suggested that the "Network Information Fite"™ be | 
printed. This is accomplished by executing the following progran;s — 
and providing the correct file name av different than ene oie : 
Se ee : | 


owe > EX. NIF/ANALYZERS FIONIF NAM USER/NCNIF Cotx) i 
NTE ANALYZER =<job #> BOJ. PR=4 TIME = 11:295:27.1 
NIF/ANALYZER =<job #> EQS. TIME = 11: 07: 12. a 
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SAMPLE NDL ‘SOURCE FILE “cLocaL USER” SYSTEM) 


mormemoetrc sce sct tse cesses sss +? —-?—-¥—-t—-¥--¥--4 1-5-9 


a petiautie | is a eden te. NOL ‘source tite to be “used as jAaue: to. thers. 


Loe NOL compiler for the generation of a Network Controlter. oriented 
- to a User System. | This) examole provides a Network Controller | 


which services a tocal site of 3 terminals» 2 virtual terminatse 
and a inter~systen connections The user must tailor this sampte _ 
‘Network Controller specifications to the needs and desires of the. 


installation (e.g.» more/tess terminals, more/less virtual 


terminal positionss etc). 


thie. seepte. ‘NDL input file is Scapeiced ae poen NOL statements. 
and parameter. specificaticns. The resulting Network Controtter | 


owe tl provide the correct. functional | attributes OCC aeAY.. Tor ane: an 


Poe ean OF. Ae sycom ayaten? in. testing EOS: 


$ CONTROL 


 $ LIBINFO. et ieee Rear oe 8 ok Ae ee 
-- $ NSSIZE 20 San ot x nuaber of entries; for IOLOG — 
hog, ae VSSIZE- 150000 wee te eae _s ‘nuaber of bitss » for TOLOG 


cay casts anne ree 


NM rNm HR 
i) 
@ 
iw) 
pe 
® 
be | 
® 
ee 
oa es 
nr 
4] 
} 
er 
od 
& 
= 
NNR NH 


DECLARATION: a 


 ONIF = "USER"/*NCNIF™. 2% NIF fite names user option | 
OMAN FILES = 165. 6. °° 2h. (ee oe ae? 
MAX BUFFERS = 2. | 
MAX MESSAGES = 20. — 


a toe LIBRARY SYCOMDECL 


yA x 
a | Requests and Conunoie’ 374. © ee. tke, « 
a ae ee rr ee me Te we oe 

h 


“LIBRARY SYCOMREQ a.  & 
LIBRARY CANDEPOLTD © Xe 
LIBRARY CANDEFSLTD = ss ewe 
LIBRARY SYCOMCTL 2 2 
LIBRARY CANDETDCTL | ee <2 ce 


tf Aww a we? 
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BPS SSS SSS SSS STP S TS RS SSS STS TSS SSS SS SS SS Ses ST a Tes SSS TS ST TESS TTTeH ss 
x : x 
y 4 Network Confitguratton yd 
a x 
AaB SRB at nase et sss Sesser sees tes esr senses ees eS ss sts se esse esses esses t=y 
ee ae ae aD em ee a a en oe eo oe ae ee on a a eo a a a a So om ae sess == 7. 
4 vA 
% Terminal Section z 
vA z 


TERMINAL DEFAULT SYCOMDEFAULT: 

7 REQUEST = SYCOMREQ:RECEIVE> SYCOMREQ: TRANSMIT. 
TRANSMISSION = 1. | : 
ADORESS =: 2. | oe z duster of seuiaae address characters 


BUFFERSIZE = 3849.  %2 x 1920 bytes : 
TYPE = 44... a z Required. for. virtual terminal asg’ S$ 


TERMINAL SYCOMTERWINALS 
DEFAULT = SYCCMCEFAULT. 


TERMINAL DEFAULT TDFLT: hee 
REQUEST = CANCEPOLTO?RECEIVEs Zee 
__CANDEF SLID TRANSMIT. Xe 


TRANSMISSION = Co | Lat 

ADDRESS. = 2. , haw 
TYPE = 44. .. a 4 Aut 

RUFFERSIZTE = 2250. | Xu & 
TERMINAL TOE24: | 7 Lae 
- DEFAULT = TDFLT. 2. Les 
Vee SS 5535255525225 25525 2a SSS ees SS 5S 552555 o> SS = SS a He Se SS Se ee SS eZ 
v4 _ Z 
4 Station Section 4 
% | % 
Lss2333=s3555->55 =— SS s5>-22S2-5== 255525 -2= 5352555552 5252-25-53 52 = =5= 25-7 


STATIGN DEFAULT SYCOMDEF: - 2.8 | | 
FREQUENCY = 250% 250. = $§Z% . MCS Controlter capability?? 
 MYUSE = INPUT» CUTPUT. a | ee an > 3, 
TERMINAL = SYCOMTERMINAL. 
RETRY Ga 


STATION DEFAULT TOBDF:. | Lae 


FREQUENCY = 2495 249. © Z** Non“Regwote SPO 
MYUS® = INPUT» CUTPUT. © al - + 
TERMINAL = T0824, © ee 
RETRY = 4e = FP %% & 


© Ss Sie me een ese om tener eter eens erennn= aa aa aon ae iss Sas onwown 7 
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STATION “CONTROL STI: | tsn 001 8 
“DEFAULT = SYCOMDEF. eres 
ADDRESS = "OO". | 


it 


STATION SPOST2: isn 002 
DEFAULT = SYCCMDEF. 


ADDRESS = "O11". 


Must be grouped. — 


STATION CARDST3: 
DEFAULT = SYCCMDEF. 
ADDRESS = "02". 


isn 03 > Secnseaea ees ee 


~Don*t have to be 
Bh cet fe, oe 2 es | oe first. stations — 
STATION PRINTERST4:. isn 004 defined. | 
DEFAULT = SYCOMDEF. -: ae 
ADDRESS = "03". 
STATION FILESTS: 
DEFAULT = SYCOMDEF. 
ADDRESS TA _ 


isn cos) 


ee te ee Se ee ee eS ee, ee 


STATION, USERTL? 


DEFAULT = SYCOMDEF. _ 
ADDRESS = "Aa™» "aa". 


isn 006 * Virtual terminal — 
| 3 is enon ene nnets 7 


i" 


STATION USERT2: | 
DEFAULT = SYCOMDEF. 


isn 007. « virtual Terminal 
ADDRESS = "Pa™» >» “aP™. 


(Program) 


MMM NNN re 


| | 7 a. Bee ewe mc eeeoen= 
STATION D1: fe : Z*¥e* isn OC& 
 OEFAULT = TO8CF. | te te ae i 
— ADDRESS = “O01. | Lee = “ee. 7, 
- FREQUENCY = 249» 250.  &*e Remote SPO t | 
ns oo - <ten 7 { 
STATION D2: _ | Zee Usn 009. a : 
 OEFAULT = TDSDF. "2 | Zee - > Local terminat. 
~~ ADDRESS = "D2". | | Zt % | 
FREQUENCY 249» 250. hee Renote “sPO 
oe 2 a a = Zar 
STATION 03: _ ae Gs Nee ‘isn 010 — 
| DEFAULT = TO8DF. ~~ a <r 


Hot 


— ADDRESS = "03".  . 
FREQUENCY = 2499 250. fit Renae SPO. re 


Lark ann aa ameaman | 
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A 
oe Line Section 
bagi ® 

ZS SSSSPSSS SS SST SSA SSS SPSAS SRA SSTPAAAAAS SST SSS SS STS sSst sess ssstssse2essese=a 


LINE DIRECTOL: — | 
CONTROL = SYCCMCTL. he. ee ea. 
STATION = CONTRCLSTL» SPOST2>+ CARDST3> PRINTERST4+ FILESTS» 
USERTL» USERT2. | ; | 


| ADDRESS = 120266 ke (tines adapters ports system) 
LENE DEFAULT LINEDFLT:: tee fa 
CONTROL = CANDETDCTL. hae | + * ef 
ALTOPGLE = 156 : Kee SK Max stations/tines | 
LINE MULTICa: _ ee adapter 4 
DEFAULT = LINEDFLT. = = = ae 
STATION = Die D25e D3. | tat | 2. oe 4 _ : 
ADDRESS = 12024. _ Zee Clines adapter» ports system) 


FILE. LINKS _.? oy for SYCaM 


FAMILY = CONTROLSTI> SPOST2> CARDST3> PRINTERST4> “FILESTS> 
ae USERTL. 4 rsnts. CCle 0025 003» O04 
> ; Yo ay ae 2 
FILE REUSER: a = _ * | tag % For progran-to-progran 1/0. 
FAMILY = USERT2. | | %Z orsn ool 
OO FELE TERMINALS? Zee This Vike 46 tae ieee 


%*e when SYCCM is run without the 


 %ee SMCS. It must be nameq | 

Zee "MCSREMCTE”® when SYCOM is cun 
7 Pe  . ee | Zee subordinate to the SMCS.. 
FAMILY = Di» C2, 03. Yee rents O01» 0025, 003 |. 


Yn men enn enn nn cen ene n nn ene nnnn--- eee ieee a hoc ces eae eae a ia 


FENTS. 


- Source configuration notes: 


aun aye wee = OM OD UDO to cnee OR oe GED oer ane sem oe oe mee Ge ee oe we ee oD a 


6 


[If the User ay atone does not have “tocal pareinates-chen alt lines 


in the above example with comments indicatec with "Lear cannes 


omitted from the source file. 
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; i - se c t i o n v Ge ne r at i n 9 t ch, e Net wo r k Cc ont c ot Mi e r s a Or: i gi i n vat ver s i on ond : . : 


save NOL source FILE “(REMOTE SERVER SYSTEM) 


negeabawity: is a sample NOL source file to be ised as input to. ena 


NOL: compiler. for the generation of a. Network Controlter. oriented 


toa Server System. This example provides a Network Controtter | 


which services one cemote site of no terminalse— an inter-systen 


connections and a SMCS. The user must tailor these sanple test 
Network Controller specifications to the needs and desires of the ens 


installation Ce.ges local erat nals: wore/tess virtual terainal 
positions» etc). | | oi ay, | 


This sample NOL input file. is sGaneiead of ‘both NDL statements. ve 

and parameter specifications. The resulting Network Controller | 
will provide the correct functional attributes necessary for ne 
apecat lon of ‘the: SvCon ey ecem ina test WOCE « 7 


CONTROL | 

~LIBINFO "43 at _— | we ote, Oe a eee 

NSSIZE 20. be, ee 7 nuaber of ‘entriess for I0L0G 
Waphee ASN000 © 2 % nuaber o f bits: for IOLOG 


dia 8 ee 


mM rN NN 
© 
ey 
O 
pont 
& 
om | 
® 
‘ f- : ada. 4 Pied 
pe | 
”n 
® 
fs) 
re 
ad 
Oo 
pe | 
NNN RN 


(DECLARATION: 


NIF = PSERVER"/J®NCNIF™.s Z NIF file names user option — 
MAX FILES = 16.2. an ce? See eae 
MAX BUFFERS = Ze 

| MAX MESSAGES = 294. 


$$ LIBRARY SYCOMDECL 


NRNNr NN 
a 
© 
QO 
wd 
@ 
a) 
ce 
wa 
® . 
= 
o 
© 
= 
oF 
bo | 
© 
giiee 
ui 
NRMrNR ve NR 


$ LIBRARY SYCOMRES 
$ LIBRARY SYCOMCTL 
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Y= cae one. oe Soe SaaS ee ee a ae eee SS aS SS Se ea Se aS eS ee ae eS Se Se ee eS Se SS eee ee ee eee 
% | z 
he Terminal Section y 4 
vA z 
fe Fonseca een ener pe Vt nen nee On ena on a RID ED ep eee ee AES eae > SEP e Ene ae ===> 7 


TERMENAL DEFAULT SYCOMDEF AULT: 


REQUEST: = SYCOMREG:RECEIVE> SYCOMREG? TRANSMIT. 
TRANSMISSION = 1. 


ADDRESS = 2... = - Z% Nuaber of reer address characters 
-BUFFERSIZE = 28409, £2 x 1920 bytes 


TYPE = 44. | |  & Required for virtual terminal asg*s 


TERMINAL SYCOMTERMINAL? | 
‘OEFAULT = SYCOMOEFAULT. 


tt: = 
v4 | z 
nk Station Sectton 7s 
b | % . 
ea ae bel =S a SS SSS SVS SVS SV VSR SS TS SVS ST SSS RRS SS ST TS SasSssa=Z. 
STATION DEFAULT SYCOMDEF : | a rns ee be ve 

Ven ee = 250, 250. | x MCS Cortrottler canpatitlity?? 

MYUSE | INPUT. CUIPUT. ee he 8 a ae 

TERMINAL = SYCOMTERMINAL « 

RETRY = 25. — 
aaa Pie eee ne ae ele ea eee ae a alr alia See Se a = “== 


STATION CONTROLSTL? 
DEFAULT = SYCOMOEF. - 
ADDRESS = "OO", — 


on) ee | 


STATION SPOST2: | 
DEFAULT = SYCCMCEF. 
ADDRESS = "G1". | 


{sn 092 


na 


Must be grouped. | 


STATION CARDST3: 


z 

z 

z 

% 

x 

x 

% 

% 

x | | | | 

| es ee Ce re 
DEFAULT = SYCCMDEF. © 2% | | | 
a a x. 
x 
x 
% 
x 
x 
x 
x 
x 
x 


ADDRESS» — "Oa". 


first stations 


STATION PRINTERST4? defined. 


CEFAULT = SYCOMDEF. 
ADDRESS = "a3", 


isn 004. 


STATION FILESTS: 
BEFAULT = SYCCMCEF. 


: 
( 
j 
j 
! 
| 
| : | 

—tsn 005 1 
= é j 
ADDRESS = "04%. | 4 


Lanna nna monroe = — a 2 oe a 4 Anew ane waa sannosanwranaamawenecanaaoen % 


Pontt have to be 


FILE ‘MCSREMOTES 
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STATION SERVERTI2 isn 006 * Virtual terminal 


pA 

DEFAULT = SYCCMOEF. y 4  CSPO/terminats) 

AODRESS- = a “Aa®. z | - i. ee 
STATION SERVERT2: LH sen 007 * Virtual terminal 

DEFAULT = SYCOMDEF. | ae 4 = i | 

- ADDRESS = “aP™» "Pa* co” 2 | 
a a a aaa a ke aa ae aa 
z ey °] 
%, Line Section 4 
yA - 4 
{esasndessaeeensoseasssselusleecsseuleseseusscesesteesceslsesee=2 


LINE OIRECTOL: : = 
CONTROL = SYCOMCTL. z= rent 
STATION = CONTROLSTI> sPOsT2> CARDST3> PRINTERST4+ FILESTS» 

— -SERVERTI» SERVERT2. 


| ADDRESS = 12026. = x (lines ‘adanter ports: system option) ; 
FILE LINK: XS) for SYCOM 


pee = CONTRCLSTI1>» SPOST2> CARDST3» PRINTERST4s FILESTS. : 
| rr y rsn's QO1ls “0G OGor 004», 005 


wee RFSERVER: | 


For prograa-to-prograa 1/0. 
FAMILY = SERVER T2. | 


z 
Z rsn QOL | 

% Notes There is only 1 device. 
% defined here because the 

% sample test program is a 

% single user program. 


% This file is used for the 
% virtual terminats assigned 
% to Server System's SMCS. | 
& rsn 001 | | 


FAMILY = SERVERTL. 
FINI. 


Source configuration notes: 


ere Seine Ne tenn UE ete eH Ma ae ome RD ane A) <h <b cee EP em ‘on we con aw vew cme 
ND tn = cree OU I UNE QD SITE CERRUTI ENED EU ARETE UD FUND EDD Oe “END OU OR OUND UE GID a ee ae 


The iahuonk: Controller source file for a Server Sviebee with. | 
local terminals" is configured by appropriately adding the NOL 
‘statements identified in the User System PRewE Ne. with "Zee" as. 
— cosments. : a: 


SECTION VI 


APPENDICES. 


Fs Aeatienpren » SYSTEMS COMMUNICATIONS MODULE aiioe “48. sep Scat 


| a ae. secet t i ° n vr A pp endi 1 Cc es : o _ o | 7 7 ~ : _ : on ¢ ori i a i n nal ver: si on ” iS 7 a 


: ae ee ae 


—DescRrPrrON 


During coweena: processing Waeious « errors say oceune: the response 
error messages and their meanings are showr below. There are six 
classes of these error messages: << a A | 
5 aie aha ae 

Ss. Command Informationat Messages 

e “system Paraeeter Error Messages — 
oe “system Error Messages. 

sows System Condition Messages _ 

- System Fatal Messages 


| One: following error message groups describe att messages ree may. 
be eae in each of the above identified mes sage classes: _ 
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Command Error Messages. 


The following error messages are displayea as the result of the 
improper use of SYCCM commands. Generallys an error can occur 
for one of two reasons?’ they are: | _ 


ode Invalid command syntax. 
2. Invalid parameter data. 
Although the reason for each error message is recagnizables there. 
has been no attempt to group the messages into one of the two 
categories. The totlowing command error messages are howevers 


or ouped alphabetically» by command» to make locating easier for 
the user. _ 7%, . | | 


COMMAND MESSAGE REASON 


UNRECOGNIZED COMMAND Xeon? 


This cenly means. that the last SYcoM command entered 
was not a valid command. : 


Le et rg oe ee 


THERE IS NG wPUTe IN PROGRESS TO “ABORT. 
| An ABCRI command was entered with a sneenened option of 
of "PUT" and ro file is being transmitted at this time. 
THERE: 1s NC 'FETCH® IN PROGRESS TO ABCRT 


Ki ABORT Counend was entered with a specitied option of 
of “FETCH” and no file is being received at this time. 


- UNRECOGNIZED OBJECT CF ei ie <Xee eX? 


The eoneand was entered with an option keyword which 
was oe "PUT" of “FETCH™. Try agaAINee. | 
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. Command Error Wessages (continued? 


<n me Gn ae Gs an af aD aD a an an a - = oe ao om @ irae ite lontede deen 


COMMAND “MESSAGE - REASON 


eCL: 
UNRECOGNIZED COMMAND écL xX>- 
The CL command was entered either dit hout an. 1 option 
or the een was found to be invalid. — 
CONNECT? 
| "CONNECT. FAILED": VIRTUAL TERMINAL TABLE FULL : 
ee, message displayed indicates that att ‘altocated. 
 Svirtuat terminal" positions are currently in use. The — 
terminal user aust try aga, at a. later. times | a 
STATION ‘ALREADY CONNECTED 
This enty means that a ” CONNECT" eaaasne was. entered 
from a terminat (Cor SPO) that was. already “connected” 
to a Server Systems no problem. | 
COPY: 


a. a Om we ae we 
ae ane «EE nae Ee eee 


INVALID “USERCODE SYNTAX 


The "=" equal ‘sign detiaiter is rissing between jie’ 
keyword. "USER" and the assumed. usercede character 
ene 


CANTT SPECIFY. USE RCODE TWICE 


The “usercode™ eheecads is already igaaeue on to SYCOM»s | 
therefores a second user with the same identifier. 80S 
not POP MAETOG >:: 7 
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Comaana Error ‘Messages Geant ncedn® 


COMMAND ‘MESSAGE REASON 


; ee ee Seeman aac enm ase ee wm mows awe wer man ames sac amaas wanna maneceneaen eae 


-COPY (continued): 


we wee ree om) ne em: Ge Gm CU ON OD Lams naw oP oun cme ee 
a ae OR Ee ND CRED ES coe HOW SE RE OD ABE GE oR ER apm SH 


INVALID USERCCOE NAME. 


The "usercode” entered was rejected because it. contains 
non ene euee we characters. | : 


USERCODE | MAY Nor HAVE MORE THAN 17 CHARACTERS 


The teageth et the misencauer aneened exceeded. a maximum | 
eeUowente length of 17 characters. . 


INVALIO PASSWORD SYNTAX 


The "=" equal sign deliniter is missing ee between on oe 


the keyword “PASSWORD” and the assured. peeeners: i 
character string. : 


CAN'T SPECIFY PASSWORD TWICE 
The “password” entered has already been specified by 
another users it was rejected fer this reason. : 

INVALID PASSWORD NAME 
The “password” entered was rejected because “ contains 

| non- atpneber ic. characters. | S. ed 

PASSHORD MAY NOT HAVE MORE THAN 17 CHARACTERS: 


The length of the “password” entered exceeded a maximus 
ae hornet length of 17 characters. 


INVALID FILE ATTRIBUTE: <token> _ 


The command syntax expected a keyword of "US" "USER"»> _ 


or “PASSWORD" which was not located. ots i ace 


entered is displayed an the message as “token”. 


COMMAND. 


—— s1e00vei700 s SYSTEMS COMMURT CATIONS woouwe az sep pie 
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(Command | Error. Messages” Ceontinued) 


MESSAGE 2 REASON. 


Cee ee rrr = a Se nero anna ces aenaaane : 


Sear (continued): 


ae <p we am om ae aE «ae oN am 
; ee a ee ee ee ee ae eee 


ee nee. ee nee, aD a 8 a 
. > Ne ED CEP com 


SIWVALID FILE. ATTRIBUTE DELIMITER? <teoken> | 


To be defined. “se 


TNVALID TERMINATION oF FILE ATTRIBUTE. Lists, <token> 


The. command syntak ‘Gatts for the Sieeheods=paxsucras ia: 


- be delimited by a. le Jase close paren which was not located 


FILE 


in the command string. The character (Cor. characters) 
that was found is avepnayed in the error message. 


NAME PISSING | 


rhe: ieaeena syntax requires a "file inaae* Soacttied. 


that is the subject of the fite transfers it was not. _— 


given or was not are cognureds: 


RIND: 


DEFINED. THICE 


The *KIND* optian: biyaord has been previously. specified 


«im the command Sthing. 


MISSING "=" 


The command syntax requires a "=" gauad Siok detiniter. 


between the keyword "KIND® and the kind option. mov uorde 


which as missing. 


wyatt KIND ATTRIBUTE 


The pind Sarton. keyword was. not "PACK™s "PETAPE™, 
"TAPE™» "“TAPE7™>» or "TAPES" which wakes. sunt Mas, 


oo: entered invalid. 
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Command Error Messages (continued) 


= COMMAND MESSAGE REASON 


wh He CR ae OE Ot OR Cee a EE Ge ee Oe ee coe eR ae oe 
1 Ae GRD rE ED ce RO em OR HO eet weed I fee <P am em oa 


‘HOST ATTRIBUTE DEFINED TWICE 


Vee defined. 


MISSING "= =" AFTER HOST ATTRIBUTE 
The peuuiecd "=" equal. sign delimiter. used between the 
Reyne ee Sonal and the host “system name" is missing. 
INVALID aoe NAME © 
The host mentee name entered was rejected because it 
contained non-alphabet ic characters. 
HOST NAME HAS MORE THAN 17 CHARACTERS 
| Hhen a. host system name is enterea with more than 17 
characters (maximum allowable)» it will be rejected. 
UNRECOGNIZABLE VOLUME ATTRIBUTE - 
This sessage is soacwhae” sPleaang in that it is ‘onty 
an indication that a keyword of a oe "HOST" was 
expected and not found. : 7 | 
MISSING "> BETWEEN VOLUME, ATTRIBUTES 
An. attribute separator Chumaecer: cf "r," 15 peared: 7 


ts the command syntax to indicate the end of the attribute 


"KIND™ and its assoctated option ihe ie It ts not 
there and it 1s wanted. | Soa. | 
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Command Error Messages (continued) | 


— COMMAND “MESSAGE. | REASON 


late Naa laa alee ke tee lea heehee tbat teln tate tbetetatttestate kate hete ttt tetenttetakatetetetekabetetetekateked 


scopy (continued): 


om cay <iet <a ce cen aD we mt cm emp eee dm om ED am, am we 
PS HE EE CE OD EOP GED EEN EN AD OND aD GD <amD co ame 


NO VOLUME ATTRIBUTES DEFINED 


Neither the “KIND or the "HOST" keyword. atveibuces 
were specified in the command string and "HOST" US.i « 
Tequtred as 3a minimum. | | Be of 


VOLUME. HAS MORE THAN ww CHARACTERS _ 


The. yo lune nueen Cor pack=ias sa eered: greceded ne: 
maxiaus atlowable length of 17 characters. This message 


: -coutd relate to either "volume- a or “volume-2" eer arr 
* ocaraahion: HOST NOT ONLINE 
(The Dest ination: Host. Name cpecaated: in. the ‘COPY command 


| string: is not a “locat" or “remcte™ systen identifier. 
“Therstorey the poaueet cannot be eae as 1S. 


INVALID. ‘DESTINATION, nose NAME 7 


i ee “destination® system name speci fied: is not the ‘sane 
ase ‘the "tocat"” system name. Therefore» because the name 
| ae not known to ‘SYCOM, it cannot pEoce ss the PeGuga ke: 


SOURCE HOST Not DEFINED OR REMOTE HOST NoT ONLINE 


“This aessage can be displayed for any one of ia vapais 
reasonss they are: 1) the systee identifier specified 
as “source host" is neither the “locat” system or the. 
current "remote™ systems 2) the required syntactical | 
- keyword "FROM" is missing» 3) SYCOM is not connected 
to the source host ape case or 4) peaviece. paccns | 
are is Shae la y *eed ) 
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€ommand Error Messages (continued) 


COMMAND | 


MESSAGE REASON 


‘ 
ma om 2 ee ee eae ee a ee ee ae, es ee, ee ee ee) eee ee ee ee eo oe wee. @© 2 2 OS Oe Oe eaeee line @ ee @ @ @& 


aon a a OM mete Gane sem ee eee 


wee ees ee cen ee ee cee ome 


INVALID SOURCE HOST NAME 


The system identifier specified as a "source host” does 


not match the “local” system name,» the “remote” system 
namere and is not ttanks. The reaquest is not processed. 


CANNOT FETCH WHEN REMOTE SYCOM OFFLINE 


This wessage is indication that an inter-systea fine 
connection does not presently exist and the "FETCH" 
neanest cannot be accommodated. - 


“SOURCE ANC HOST NAMES MAY NOT BE DEF INEC IN a FETCH 


Use of the shorthand version (FETCH) of the COPY. 


FILE 


ae 


command implies the source and destination aye reese 
Ehece tore: they cannot be specified. — 


stile. name> IN USE ny DESTINATICN=-PUT “ABORTED 


This message is displayed when SYCOM is attempting to 


"send" a file te the other system ‘and the eee? 


file. is. currently. in use on that. system. 


<file name> IN USE AT DESTINATICN--FETCH ABORTED 


The file in question has been received and when closing 
it (which removes existing namec file)» finds that the | 


file to be replaced is in use. The FETCH is aborted. 


FILE 


<fite name> NOT FOUND 


The object fite for a PUT file transfer was not found. 
in the disk directory favek? or was not online (tape or 


oes aes 
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| Command | Error Messages Coontinuedy : 


. = COMMAND MESSAGE REASON 


ine sealed cme ance a lekeiedeteiketetet tetetet de ttt tt tt tt hr hn “<= pis 


corr (continued): 


PN NN Ree eee eee eee eee 


FILE, <file name> Locke. 


— The ‘object. file ioe. a put file transfer. was found to ‘pe 2 


"locked™ in the disk directory (disk). 


A <file name> FILE TYPE CANNOT. BE TRANSMITTED 
Re: disk tile specified “Ge the. file transfer. is - not 
one of the file types which SYCOM can transfer. CNo 
= code files disk tape or pees. disks onty data files. 


FILE <file name> “source OR ‘DESTINATION FILE NAME MISSING | 


This message indiéates that a subject Gis name was 
missing from the command string which was entered as — 


either a "COPY™» SPUT™s or i ak from another —, 


FILE <tile name> > sousee of DESTINATION FILE NAME. INVALTD 
The specified tite. nane was found. to ontain: cneeae ene” 
other than those which are considered valid for a file 
identifiers ors. A multi-fite identifier was ingles ted. 
cry but was. not included. 


CHARACTERS 


“FILE <file , ndae> FILE NAME a ee io 


: The diaweot the: file to be transsitted was found to 
contain an identifier in excess of oes characters. [ts 
the maxioua allowable. Pt. | Che Me 


“oNTO- -PACK cR USER- CODE NoT FOUND=-PUT ABORTED - | 
This aessage would occur. when. SYCOM. was petespting to. 


setup) for a disk (Cor. pack) file to be. received and. the. 
destination "disk pack” was not found) to be. contines — 


After the mos sage is cient ayed the transfer is. aborted. 


BLEQO/RI700 SYSTEMS CGMMUNICATIGNS MODULE = 12 Sep 1978 
Software Qperationat Guide | a | | 7 ‘Page - 15% 
— Section VI Appendices. — So (Original version) 


Command Error Messages (continued) 


COMMAND MESSAGE REASON | | | 


COPY (continued): 


RO SAS RS ON OS: RRS, AS) OES ee ES Oe, (ORS, AS OOS cee 


Fite <tile name> ALREADY EXISTS AT DESTINATION - PUT ABORTED 


When SYCOM is setting up to “recetve™ a disk Cor pack) 
file» it checks to disk directory. If the specifien 
file already exists» this message is displayed and the 
transfer is aborted. | 7 | 


FILE <file name> RECORD SIZE Too. 816 
rr record: size for the disk or tape file specified is 
too large for SYCOM to transfer with the present | 
"Kecord: Size" setting. — The ae cannot be transferred. 
| FILE <fite name> TOO MANY RECORDS: (>99999) 
The disk Cor pack). file specified bak: the file eeanstes 
contains an excessive number of recordss outside SYCOM | 
Limitations. The file cannot he transferred. 
FILE FAMILY NOT ALLOWED 
AS Suspecteds tr the specified file name» an equal sign 
("=") was found which represented either a "pack-id">» | 


"multi-file-id"s or "file-id"™. This is illegals the 
file named must be specific. | ba ts 


eDEBUGE 


ERROR - "ON" OR "OFF" EXPECTED 


The SHOR: caved entered with the. DE BUG command is 
not valid. Please Cy again. 
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Command Error lievongea Cent inueds: 


aa am eannmanmnaane He MORN 


- COMMAND 


‘MESSAGE REASON 


jorsconvects 


ow ame ene ae em eum «mm cme eee ae 
a ON OR Em, OR TE Em -emO eRe wa 


wm ane 
a ee 


ai “STATION ALREADY DISCONNECTED 


This enky means that a "DISCONNECT". command was” entered 


from a terminal that was already disconnected; (it was | 


ignored. 


| a i A eee ome 


OR WAIT IN PROGRESS: 


>: oh means that a "WAIT" peewane: has been entered: ‘ana 


eF ETCH? 


a a ae a a ae 


SYCOM is responding to this Paquests the "eEOJ" command 
is tgnored. | | 


CANNOT FETCH WHEN REMOTE sYcoM OFFLINE 


This nessage {hdieacion that an inter-system line 
connection pee fot presently. exist and the eon 
Eoocet cannot be accommodated. , 


SOURCE AND HOST NAMES MAY NOT @E DEFINED IN A FETCH 


7 Use of the shorthand version CFETCH) of the COPY 
. command implies the source and destination systemsr 
| therefore» they cannot be. Speen eed: | 


FILE 


<file name> IN USE AT DESTINATION--FETCH ABORTED = 


‘The file in ‘euestaion was received. and when attempting 


to close it (which removes any existing fite copy)» a 
finds that the file to be. replaced is currently in use. 
The FETCH tis aborted and the. received fite is tost? it | 


must: be requested again. 
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Command Error @eenane Ccontinued) 


Rane wren Denna anna ea SRO n eon nen enn nannane 


COMMAND, MESSAGE REASON 


m—p wm ae ep 
mn Gn ee we aE 


UNRECOGNIZED OPERAND "<token>” 


‘This. simply means that an incorrect or misspelled _ 
option keyword was entered» and rejected. : 


-OFFLINE? 


—— wa ae ew tem com <p cow oom 
ow a ne ew A ae oe wee eee 


eae ae WAIT IN PROGRESS. 
‘This message indicates at Sycow is in the process of. 


servicing a “.WAIT”® command which tn effect produces an 
“offline” conditions the "OFFLINE" command 15 ignored. 


ONLINE 


This command does not cause an error message. 


1 em On eT erm am ene 
ny OP aD ae uEe 


INVALID PHONE NUMBER 


This. message as returned when the phone number entered 
is either more than 20 digits in length or contains — 
ede characters. , | 7 


an «am WR we 


CANNOT PUT WHEN REMOTE SYCOM OFFLINE 


- This message means that an inter-system connection does 
not presently exist» therefores a “PUT” cannot be done. 


Section VE Appendices | 
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“Command | Error Messages Ceont inued) 


preyed % MESSAGE. REASON. 


om pole ese selene acueaeesace | Ueuecaaeeeos 22 me nen enema ee ae sean we cee 


“pur. Ceontinued): 


<r sen no etm aE nem ane ~ene eam en me aie ae came on ae we 
TOP RO COD AED AND ND A OD ED SD OED EN ND OND. eee we 


| | SOURCE OR CESTINATION HOST NAMES. MAY. KOT BE DEFINED. IN: PUT 


Use of hie shorthand. version “(PpuT) of the COPY ‘oaeana. 
iaplies the source and destination. systems» thereforer. 
oehey.. cannot be specified in the command Seernge=.* 


FILE. <file name> IN USE at DESTINATION--PUT ABORTED 


= This. sessage occurs when SYCOM is attempting to nameee? 
a file to the other system and the specified. file as 


currently in use on that ay ecer: The PUT is aborted. ane 


ERROR? NO nim IN nas COMMAND 


This gessage occurs when a mas” coemand:. is entered. and - 
the required equal sign *%=" was pissing. The function — 
requested oY this: command was not. done. | 


ERROR: * meas" OPERAND Wor. NUMERIC 


ERROR § "as" CPERAND | Kay NOT EXCEED 15 


The "as" conabie ‘is entered with a non-nuaeric queue | | 
size integer field and was ignored. It is necessary to 
re-enter the coamand string in correct (Onmete. 


e. 


a The queue. size integer sunanea: was Gieater, chon 45 aad 
was summarily rejected. It must ne: re-entered with an. 
| appeapraere: raeeser venues: | | 


-— eRROR: "ase OPERAND HUST BE AT. LEAST 7 


The queue size aaeease eneer ea. was cere ahan. re ete ues 


4 and was rejected. The command rust be rerentered with. 
a legitimate unteger value, 7 | ee 


Coriginat Version 
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Command Error Messages (continued) 


‘CUMMAND _NESSAGE REASON 


eR Y3 
UNRECOGNIZED CORMAND <Rv XxK> 
‘The command string contained an urrecognizable option 
keyword? not "CP", "LPs or "CR™ 


‘ee ne 


ERROR? NU "=" IN ".SIZE" COMMAND 
This message is clear» the command syntax “requires” an 
equat ‘sign. = ) prefixing the size integer. 
ERROR? ".SIZE" OPERANO NOT NUMERIC 
The integer entered with the command string: was 
comprised of at least one non-digit characters The | 
integer must be all digits» no exceptions. 7 
ERROR: “.SIZE™ CANNOT EXCEED 400 
This message 1s disptayed when a size integer is. 
entered which exceeds the maximum message Stock size 
established for the systems four hundred (409) bytes. 
ERROR? ".SIZE" CANNOT GE LESS THAN 78 
Thes message is disptayed when the size integer. entered 


is fess than the minimum atlowable message b lock Sizes 
for this system the mintmum size is 46 bytes. 
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Gouaand. Error Hessages Cedntinued) 


(SO we cena ene enenn mw ee me emssnaanen 


COMMAND “MESSAGE | REASON. 


enn oe ee ween ee eee ne weet etm enoencne ana aa nananaananaae oon wm aw aw aoe . 


a emma a 2m aoe 


e3Vs 
UNRECOGNIZED: COMMAND <u £xx>> 
The oSV command as entered either aiehaut an option 
or the option entered was found to be invalid: Cnot "LPS 
or en ae . 
eUSER: 


‘INVALID USERCODE NAME. 


The usercode used to Loge on with has been found to pe 
invalid. Please log-off and Log-on again with correct 
usercade/passwort Combinations 


INVALID PASSWORD NAME 


The password unté the. user sagneasen with has been 3 
found to be invalid. Please log-off and Log-on again : 


with a correct usercode/passworc combination. | 
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Command Informational Messages 

COMMAND MESSAGE, REASON BS 


_SyYcom anes CANNOT ACCEPT INPUT 


This message is returned in response to any new command 
entered “after” an ".EQJ" command is entered but prior 


_to the actual shutdown of SYCOM. (Once shutdown has 


heen initiated» commands are no. longer accepted.) 


ma a i oe Ale 
wa PY ewe GS aR aw 


REQUEST IGNORED? CARD FILE STILL OPEN 


This sessage is displayed if a ".READ™ command is 


entered when an input card file is currently active. 
The entire command string is rejected and discarded. 


REQUEST IGNORED: NOT LOGGED ON 


This message could mean the card reader is not ready. 


FILE "RJECAROS™ NOT PRESENT» TRY AGAIN 


To be defined. _ 


ee 
rn CaP iE re ae ear 


Ye CCANIT ‘SCHECULE NOWS TRY AGAIN LATER 
To be defined. 

“nequest seneouee: WILL SEND FILE <file name> ASAP 
To be defined. — 

“neout st scweounea=-renete SYCOM OFFLINE 


To be. defined. 


co aubanes SYSTEMS COMMUNICATIONS. Sota 12 Sep Are 


Mee Syste! Paraneter: Cinoe? Massages: 


: ew rw eee ence ere eee cenaseee ce 


the: fotloving. error messages esa occur auciae. the parameters. 


input. process. The problem. indicated applies to both SPO. ek 
as well as card input. In either cases SYCOM must be DS*ds the 


probleats) POrESE RECs and the parameters reentered as required. 


MESSAGE. REASON 


- sycom =<job” t> INVALTD PARAMETER: | <token> 


| This message is displayed uhen: the paeeeecer keyword entered 
did not match one ‘ef the Seceptabite: keywords. 


—-% SYCOM =<job_ a> tee EXPECTED BUT cot ‘asia 
The par aestecs which She Luda: a gatue gust be eeusested by 
the "=" character. In one of the paraseters: entered this 
word separator was” missing ene ae is Metoratyend.: in these 
pmattets=: | ‘3 | 
+X SYCOM =<job #> INTEGER EXPECTED BUT GOT <token> 
The BUFFER and. RECORD. parameters require an integer which i 
specifies the BUF FER/RECORD size in bytes. As this is not | 
what was entered» what was found is included in the. message. 
 -% SYCOM =<}ob #> surren stéé exceeDs WAXT MUR ALLOWABLE 


The maximus allowable BUFFER size is 1950 bytes. What was _ 
eee exceeded this Aimit. eee ee 


3. “4 sycom =<job a> RECORD SIZE EXCEEDS WAXTHUM ALLOWABLE 


_ The maxinue allowable RECORD size. is 1950 bytes. What was. 
ee emEencs exceeded cues Liait. 


& sycon =<job_ t> INVALID SYSTEM. 1D. we 


The "systen ian entered has exceeded the parameter Aint of ee 


17 bytes. Please shorten it. ue. some and reenter. ite 
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sy stem ‘Parameter Error Hess ages (continued) 


MESSAGE REASON 


» SYCOM ince RECORD SIZE EXCEEDS BUFFER SIZE 


The integer snbered for the parameter "RECORD" exceeds the 
current “BUFFER” size. Do tt ada uns 


—% SYCOM =<job #> INVALID PARAMETERS FILES BEING REMOVED © 


“This message occurs when the "PARAMETERS file is opened» 

the parameters are read ins and the "maximum tuffer size" 
was found to exceed the system maximum of 1950 tytes. When 
this condition is encountered, the "SYCOM/PARAMETERS™ fille: 
is removed and new paraneters must be entered. | 
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‘Systea warning Messages 


Warning. abesages displayed on the User SPO indicate a probtem 
at the systea. level. They. have been rectified by SYCOM so that 
operations can continue without operator intervention. They are. 
not generally considered to be aajor or extensive in nature and 
therefore, ‘SYCOR has elected to take immediate. corrective action. 


MESSAGE REASON 


om ee www ew eee ee mm ew meen een eee nowoen aw oe seeeewowasae ec ewnrorsn= 


ies as REMOTE rte kein. es anaes 
% ee #> <60 or less. characters of aeseege2 


“self explanatory. — 

x SYcon wa: #> INO “OVERFLOW FOLLOWING MSG DISCARDED 
2% SYCcoOM =<job > <60 or iess characters of Bee eaer 
Self explanatory. 


~SYcoM eeise "> TERMINALS FILE OVERFLOW> WESSAGE. DISCARDED 
~SYCOM =<job #>- <60 or less. Cnet Bet ehs of. message” a 


ee. 


‘self explanatory. 


- sycoy =<job #> ERROR: MESSAGE TYPE = <type code> 


This nessage indicatés: ‘ehat ‘Che. caput message eyae ieeceuved: 
on the remote file PLINK® is incorrect and the. messe3e has” 
been shunted (off. | 

“-% SYCOM =<job #> ERROR: ‘INCOMPLETE 10 ON LINK FILE 


i si be defined. 


ee ee LINK QUEUE OVERFLOW. MESSAGE DISCARDED — 


a aaee 


x SYCOM =< job a> QUEUE, RJEG FULL MESSAGE. DISCARDED 


To be defined. 
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System Warning Messages (continued) 


MESSAGE REASON | 


1 SYCOM =<job #> NUMBER OF TIMEOUTS = ai ; 
‘This message 1s displayed automaticattly when “timeouts”. keep | 


—resoccurring on the inter-system tine connection. However, 


it is onty output on an incremental besis a to reduce SP 0 
ee activity. | | | 


Y syco™ z<job > LOSS OF DATA=SET-READY 


Disptay of this message occurs each time the indicated event 


is detected. A count 18 maintained cf these occurrences and | 


SYCOM joes into the state of "initialization*. In progress 
file transfers are aborted and tost. : ae a 


“2 SyCON =<job > HOST SYSTEM CARD READER HALTED 
“When this message occurs it is to infora the syster operator 


of a condition that presently. exists on the remote enone e 
No action is required aa the Pe ne : 


2 SYCOM =<job #> HOST SYSTEM CARD READER ABCRTED 


This message 1s used to inform the syste: seers ie. that. ‘card - 
ceader input from the remote system has been abor ted. No 
action. is Ceaune eS. of the operator. : 


yg SYCOM =<job #> HOST SYSTEM CARD READER READY 


A message that is used to intone the cent aystes operator 
that card input from the remote system has resuaeds. | 


% SYCOM =<job #> SYCOM WILL CLOSE adidas”. 


Sel f explanatory. 
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Syston Warning: ‘wise ‘Coonk drive. 


mo Sen wena wenn eawene enabonnwe mt 


| MESSAGE REASON 


fe x syco. =<job- rs REMOTE svc 


* “s¥EOn =hob o> SYCOM “cLastNG: ON REQUEST FROM REMOTE sycom 


‘Self explanatory. 


Se RS ‘svcoM = <job i ERROR? “MESSAGE TYPE. <message type> 


An input message ennw the remote file "LINK" was Fouad to aa 
invalid. The message. ‘type code is included in the displayed 
error message for references , et weg! & Be | 


0M MAS 6 GONE. ‘OCWN AND COME BACK up 


‘This message is self éxptanat ory. 
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System Condition Messages 


Any of the following messages disptayed on the User SPN indicate 
an abnormal system condition of some type. As a rules when one 
of these conditions is ercountereds the disclay of an. appropriate — 
message also elicits: a response from the revere obenauars 


MESSAGE | see 


% SYCOM. Beas #> CARD PUNCH EXCEPTION | 
% SYCOM =<job. #> PLEASE ENTER "RY CP" WHEN DEVICE IS READY oR 


".9V —* TO SAVE TRE FILE. 


This message is dieotayed when SYCOM 1s. attempting to punch. 
a card and an “exception® condition is encountered. — 
Generatly this indicates that the card punch has gone "not. 
ready" for any one of several reasons. It is necessary to 
respond to SYCOM with the appropriate commanc when action 
ues been caren, to. ‘peaey we aes =~, | 


a, SYCOM eeron: > LINE. PRINTER EXCEPTION 
% SYCOM rion #> PLEASE ENTER ".PY LP™ WHEN DEVICE as READY OR. 
"eSV LP™ TO SAVE THE FILE 


Ihis message is displayed when SYCOM is atteapnting to print 
a line and an “exception” condition is encountered. 
Generally this indicates that the line printer has gone "not. 
ready” for any one of several reasons. It is necessary to 
respond to SYCOM with the appropriate command when action 7 
has been taken to eas the untt. | | 


% sYcoM =ejob it > PARITY ERROR ON READ PLEASE READ LAST CARD AGAIN | 


This message is  aieetawee: when SYCOM 1s attempting to read. 
the card file and an "exception"® condition is encountered. 
Generatly this indicates that the card reader has gone "not 
ready” for any one of several reasons. It. is necessary to 
respord to SYCOM with the appropriate command when action 

has eeen taken to eeaey the unit. 
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Sy. ste. Condition Nessages (cont inued> 


MESSAGE _REASON a. | eens 


r sycon shed esha ERROR 


The. ceed punch has either devacted an error. in the iast- Caen 
punched or has degraded into a "not ready” state. — In. either 
Cases a “suspend” controt message has been sent. to ne | | 
Server System. 7 . 


og sycom =¢job #> READER ERROR 


The card reader has either detected an error in the last 
card reads gone into a “not ready" states» or. has detected an 
invalid character in a card columns other than cotluan 1. If | 
there was a read errors the last card aust be put back into 
the card hopper. The card reader is then made physically. 
"ready"s all cases. -SYCOM must then be informed of this new 
ohatue: condition with the entry of a “.READY® command. | 


~ ‘SYCOM =<job #> PRINT ERROR 


- The. tine peinter has. either: detected an error on the set: | 
tine printed or has gone into a “not ready* State. In both 


cases a “suspend” control. message is sent to the Server oo 
ey eles: When everything is again ready with the Printer? a 
"READY" command aust: be entered to inform SYCOM. 


1 sycoM =<job #> CARD READER eae’ 
This siaply @eans thé: card “input has been completed and the 
ae file closed. | | 7 
a sYcoM =<job- > ac pone 
doh ‘doing a eoad ‘on the resote file mLINK™ an EOF" paniiein 
was detected. This condition is caused by the MCP when a 


"QC" command is entered; which shuts doun ath mEogT oes: 
aeeevaces with the Network Controlter. 
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System Condition Messages (continued) 


ee op OOD nan Been naa annnaannan Bae 


MESSAGE REASON | 


; cena wn ema wneaneee Se ee ae eS Se eS ee SSeS ee Se eee See eS ee evn eamane 


x SYCOM =<job n> ERROR? INCOMPLE TE 10 ON LINK | FILE 


re doing a read on the remote file LINK an *iecoun lore io” 


condition was detected. This message werely reports on the — 


‘Situation. 


© SYCOM =<job- > "PHONE NUNBER REJECTED BY NC éphone nuaber> 


reas detined. 


“2 SYCOM =<job #> INVAL TD CONTROL MESSAGE RECEIVED 


when SYCOM receives a syster “eonbrol ressage” et a remote 


system and the “type code" in this message js not within the | 


00 - 23 number ranges then the above message is displayed. 
The tnput message is discarded and no further pac cese ng 
done on. tts behalf. : . 


| SYCOM =<job #> BUG IN NETWORK CONTROLLER. VIT INDEX = <vtt> 


A "close™ message has been received from the aye vem Network. 
Controtter for a program known to SYCCHK which contained a 
"(sn. list”. This. list included a Virtual Terminat Table 


‘Index CVTT INDEX). entry for a terminal not. signed- on to that 


“programe thus the reason for this message. 


% SYCOM =<job #> LOST CONNECTION TO REMOTE SYSTEM SYCOM 


This message is self explanatory also. 
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ren Fea sense 


| ees en ene mas eoenenan 


oe eter messages” are of the tybe which. peecliue: the mutoeet (ero. 


shut, down of SYCOM. There are considered "fatal" in the out took | 


oe continuing eoUreC rons and. therefore» SYCCH is shut down. 


he peace aie ada. Pe 


ee ee 


og. sycow | =<job #> FATAL ERROR AT <progran sequence. Bee 


The digpisy: of this. aéssage on the User seo could be thes 
result of any. nuaber of reasons. The SYCOM sciete xine’ 
. nueber. displayed is the onty clue to the problema. SYCOM 
initiates a “memory duap” at this point and automatically 
goes to EOJ after certain disconnect functions. have been 
‘Satisfied. — | : 


% SYCOM = cee > REMOTE veddion. OF SYCOM IS INCOMPATIBLE | 


— &% SYCOM = aime, > ‘AIS VERSTON="<x>"» MINE= a 


“this: message ‘Gdentities: the fae vow: at hand. SYCOM goes to 
Ed immediately at this: apa nee: ~~: 


1 SYCOM =f ob | > ANOTHER sveom WITH, SAME MULTI“FILE=10. IS “RUNNING 


The display of this ‘pébs age. indicates that sYcou cannot gain 
| access to the “SYCOM/FIP.QUEUE™ file Ccn. disk) as tt is. 
aa presently in use by another DEOGr ems: 
x sycon =<job #> PRINT. - PUNCH. QUEUE OVERFLOW: PROGRAM ABORT 
Te be: defined. — - 


| SYCOM zejob #> REMOVE FTP.QUEUE OR CHANGE ITS NAME IF 7.0 FILE — 


To be defined. 
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APPENDIX Bt ‘CHARACTER SET 


The faltowins printable characters ‘detine the character set 
acceptable to SYCCM for input messages from terminals. They are 
arranged by cotumns in internal collating sequence with “blank 
tow and "9" highs | | | : | a 


“Sean | m Sy. “YZ a ho vw € oy Q wi 3 
( } , 3 b 1 p W D K R X 4 
° $ m 4 Cc j a x E L \ Y 5 
< * ® @ cd k r ¥ F M S$ d 6 
C ) % ' e l 4 | z G N T 9) 7 
t , - = f m t ae H 0 U l a) 


It is recommended that the standard "signal character" of "x" te 


retained by the SYCOM user for use in message transfers to the 


SMCS. However» 1f this 15 not suitable for any reason» one of © 
the following special characters are suggested: 


Special data communications characters reccgnized by SYCOM are as 
follows: 2 


SOH EOT OLE ENQ STX EIX RS FS 
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. APPENDIX Cz RESERVED woRDS: 


ww we ew ew en ce ee een en ens sbecneeocee oan oe we Se ce come asec eworen an ap = 


the! reserved words peceaniled by SYCON are. daecniionk upon. ine 


position type format. Hence. the following list of reserved words 


are divided into the followiig types: - 
S veu3 - Commands 
; aren & - “Speci fications 


Words which are aduaeet wolLaued by. a.word in. parentheses are 
interchangeable alternates for that word. 


“Type 1 


~ABORT a ee > ‘oS a PHONE eee 


BYE  § .DEBUG = -LOG— —C PT SOP 


oe s DISCONNECT Po SS 
sCONNECT  —s-_ «EQS -sOFFL ANE READ US CUSERD 


—.COPY) FETCH : ONLINE. RY se WHAT 


Type 20 


7 Sea | _— 7 PASSWORD TAPET usch | 
cPo2€=*~SCOST CCN RETAPE TAPES USERS” 
eR =—SCUKEND. sO Spur TERMINALS 
DISK oo AP om PACK — SCHEDULE ‘TO 


FETCH” ——oONR PARAMETERS TAPE US 
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APPENDIX Dt COMMAND SUMMARY. 


oat - tee We aD Re, ate 3 Pe Me Sas a 
a Sy: ar a ne ae 
\ 


The following command summary list ts presented in alphabetical 
sequence for easy reference. Refer to the command descriptions 
for command syntax. and. option details. i | | 


COMMAND «so STATION. LFURCTION 


ABORT “any. | “Abort a PUT or FETCH file transfer. 
wee? | {ae Ue Station. Logrott from SYCOM. | 
| cL | - spl 8 Clear per tpherat device. | 
CONNECT any - : nequestcs establishment. of a. terminal to a 
| | | | — server System. | 
COPY ; any” ope transfers CPUT cr FETCH). 
cP _ A —s§Pa ~  Taforn SYCOM of "rot ready” peripheral. 
7 DERLG 3° oPC a start/stop: input/output messaqde. tracing. 
DISCONNECT any : Request for termiral. disconnection from 
“s | -_ the Server. Sy StamMe | 
—£0d | - SPO 7 “Cause SYCOM into an orderly veneer 
FETCH Oo any File transfers (fetch from other system) 
LEST : - any a ‘Display selective system information. 
LUG SPE Display a List of cata comm error counts 
LP _ spa ; Inform SYCOM, line crinter "not ready". 
‘OFFLINE | — SPO Cause SYCOM to break the connection to eee, 
" | a eevee sy stem. | : : 
ONLINE SPQ Establish a Server System connection. 


PHONE Poe sg SPQ eetanieeh or ciear phone number . 
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COPMAND “STATION Ck “eUNCTION 


ay ee na transfers (put to other apne 


as 8a Change: Network Controller queue depth. 


READ SPO pen and teansait card input files 
RY ——sSPG — Intora s sYcoM of available peripheral. ie 7. 
stze SPQ. Change maxiaun message block size. 


stop — @ ss SPO. | 5 Cause SYCOM to shutdown ianediatety. 


Sy SP ‘Stop transmitting, and "save" file. - oe 


USER Oo any _ Log. a user onto. SYCOH. 


WHAT any ~ sycon status inquiry. 
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APPENDIX Et COMMUNICATIONS CUNTROL MESSAGES 


GENERAL 


As there are several message formats used fcr inter-SYCOM data 
communications» each format is specified in detail. These message. 
formats are presented in a sequence dictatea ty the message type 
code. A tist of message types are shown belows followed by 
individuat message. Format. descriptions. | 


MESSAGE TYPES 


The message type codes are derivatives from the "DAL"/"DAZ" 
(Device Address) field. The message tyne codes apply to message 
transmissions in either direction and are compatible between | 
system typese Following then are the device address convent tons 
used a ue all ores ee are considered invalid: 


DAI Nae Usage | | : 
Q G ' ~$ystem controt. 

‘) 1  $SPO- messages | | 
A 2. Card reader/punch data messages 

0) 3 Line printer data messages. 

0 4 File transfer data messages 


8 2°" Packed card punch data messages 

ca A «User oe "transmit's Server System 
—  theu “receive”, virtual terminal messages 
ee ) ms a ° 

OEN® 2 as > User System “receive”, Server System 
ee thrae’  ' Stransmit™.>» virtual terminal messages — 
FF g = | | 


Device adresses are : mauaauey aintives The receiving system can 
direct a messaaqe ta any. appropriate perinheral devices tased on 
Its own requirements. | 7 , a ae 
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Note. that. the. tine printer. data is atlowed in both directions. - 
When a- system receives line printer data» it can print it on any 
available printers independently of anetner the ‘systee is termed 
ae User System or Server Systea. | 


MESSAGE FORMATS 


Basic Data Communication Messages _ 


- = nemo a 2S ey St Ga a a we a am am oe oS So ce yw 


AS per the ‘line protocols the betow messace daveat adheres” to the 
| criteria of standard RJE wessage formatting: | 


“SATSDD Le oe gg 


ORNTAA<<#----"-- TEXT Ha---+--=>TC | 
“HMEXL2 = oP Sone 


the (eaten saaieia babe in this message function as follows: 


Ae SOH - This is the standard ASCI! character which is — 
' used to indicate data transmission as opposed to 
connection establisheent communication. 


Be ARM - The wacknowlédge. Received. Message” chaeedcer 
, which is used to. accept: or reject whe. cast ee esade:. 
block received. | : 


a THe - The “Transaission auebec®: characte: used in 
oo the acknowledgement. ofa message. It represents 
one of two values Calternating characters) selected. 
for implementation by SYCOM. The characters "5" and 
"8" are used by the User System SYCOM whereas. the — 
characters “F" and “U" are used by the Server 
iis SYCOM. , 


D. STIX - A standard controt character used to deliait — 
the preceding header characters: roe the meee sarees 


Ee DAL/DA2 - Two characters representing a “MDevice 
a Address” value. 


+, See wi the message text. field usually containing 
eeu cece: weages or a message. | 
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Ge FIX - the standard "“end-of-text™ control character.” 


He 8CC - A Hlock Check Character which ts comprised of - 
a Longitudinal parity bit configuration that is. 
used» by the hardwarese to verify that the message 
has been received correctly. 7 


System Control wessage 


System control messages are used to exchange control type data 
between systems. A complete descriptive tist follows the message 
format which 3s 4 variation of the basic message POU MIIESE A 


SATSOOCO' =i ( wt | EB 


—GRMTAADD<--"- variables (text) ---->TC 
HMaX 1212  "S . . & ee | Oe 
"00" 


Here we have the addition of the "CDI™/"CD2" characters. These 
two characters represent the system message “type” codes which 
may or may not ce followed by variable control datas | 


SPC Me seege® 


the SPO. esos oe! format uses ‘the basic. format. eye nout alteration. 
There gre no provisions for blocking SPO Messages, therefore» the 


| rule 1s: one SPC Message per control fmessace block. The format 
of this uyee message 1S as follows? | v2. ¢ 


SATSOD "3 4. «ee. 7 


ORMTAACeomennee= TEXT -nnen---->TC 


OO HMBXE2 _ : NOt 
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aed Reader/Punch Message 


the format. for. card  eeader/piinch data images is as. akin . The. : 
~ spCC" character represents a “printer contrcl character" which tn 
_ this case ts. "0". The. RS" (Record Separator) character used 


i, ener card images provides: the means Oe blocking. 


~saTsoor” oe re ewer 2: 
ORMTAAC<<--- card image adem sScron= card image orers td 
HMXEZC oe 7 | XE. 


ozo" 


Line bolentchlt choose 


‘the fotleutag ‘for wat variation is used to transmit Line Printer 
data Punee. pereecn oye Lease . =, a _ | 


-SaTSDOP : | ne are Mig Oe SR 
ORMTAAC<*-"> line uae wana >§cwne= Line image ee->TC 
MMEXIZC ha re : . | | 7 XC 


aa, 


This format is the same as the. Card Reader/Punch format except | 
that. the "PCcs character i$ utilized. The value of this field | 
can be one of the eottou ens: codes? | | | 7 


PCC 2 Function. | 
Print» no spacing 
Prints single space. 
Prints double space > | 
Skip to channet 1. cee of page) 


Res SO OR mine | 
Se Crees 


sete, Cotton of page) 
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File Transfer Message 


The File Transter message format is also the same as that used to 
transter card images. Although the "PCC" character field ts | 
includeds tt is anly there to maintain message conformity: 


SATSDDtti« | a BD 


ORMTAAC@=-~ record data -"-->S<---"record data ---->TC 
HERS a a oe & : : OKC 


"HA 


‘Virtual Terminal Message 


The message ferwat utilized for virtuat termwinal messages is the 
basic message format» with one exception: the "device address” 
for a virtual terminal is comprised of twe letters (1 lowers 1 
upper “transmit™: 1 uppers 1 lower “receive"™) and wilt vary by 
terminal. The format is as follows: (Tereinal and SPO messages 
are “not" blocked.) | ; 


SATSDD eg 


ORMTAAC**-----""—" message text s--------> TC 


HMAXI2 | rs 7 XC 


oxXn Ctransmit) 
"Xx" Crecetve) 


File Separator Messages 


This messace format is utilized by SYCOM when it is necessary to 
transfer a “symbolic file header™» indicate the "beginning of a 
file"™» or indicate the "end of a file". This applies equally to 
the "Card Reader/Punch"» “Line Printer"» arc “File Transfer” 
operations. To accomplish this» there are three minor variations 
to the File Transfer Hessage format which ere tdentified with the 
— following messace formats. | 
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Begin File nessage 
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‘The format. for the Begin File message is as. follows: 


 SATSDOF. a | £8. 
| ORMTAASI<~--- file name waeeds ee 
 HMAXEZ _ 3 XC 


"O2" 
"Q 3" 
| "O04" 


End File Message 


The format for the "end fite” message is as follows: 


-SATSDDF EB 
—ORMTAASZTIC. 
i HMext2 XC 


Program-to-Prograa Hessages 


the folteuiag. message fordat. serearas: to SYCOM’s "program-to- . 


Program” facilitys thru a “Remote Fite": 


REMOTE KEY 10 chatacters) x sie tadgioes 


= RSN © 3) 


ON NAN 


Relative Statton Nuaber for 
"virtual terminal™ as defined 
for the program-to-program 
remote files usually "001". _ 


+ LENGTH Wyo eo of message text. 


al TYPE. car. we X Wessace types, usually sooo". i 


MESSAGE TEXT. cnn characters) % Maxiaue is "buffer size”. 


| progr an to- "SYCOM Messages 


oe ee ee re 
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APPENDIX Fi RESTRICTED MCP COMMAND SUMMARY 


ALL input commands that are prefixed with a "?" are sent directly 
to the ¥cCP e Kactly as entered. The MCP then generates approoriate 
responses which are sent to the terminal via the Network 
Controller. Security restrictions have impcsed certain 
constraints on ¥CP commands from remote terminals. Also» certain 
commands» such as tnose which alter system cpotionss purges or 
clear system peripherals» have been disallcned for a remote 
terminal. The following list represents the MCP command subset 
permitted from User System terminals anid the User SPQ. . 


The following Command Subset is listed ir the order as descrited 
in the 818@00/B170C Systems System Software Cperational Guide 
(associated documentation). Any command Listed telow which is — 
suffixed with "US" requires the command to te entered with a 
wate "usercode"/"password™ combination. | 


Library Maintenance [Instructions | 


e CH Change (US) 
e AD Add CUS) 
e LQ Load (CUS) 
e DU Dump CLS) 
e UN Untoad CUS) 
- RE Remove CUS) 


Program Cortrol Instructions 


- CO Compite CUS) 
- OY Dynamic | 
2 = 6EX = Execute (US) | 
- MH #edify Header (US) 
e MOQ Modify (US) 
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“Progra. Controt Instruction Attributes: 
Se AE AP ber © ne 
2 AN After.Number 
CA Conditional - | | 
Charge Coertain restrictions apoty) 
: _bynamicespacas | | 
FIO File | 
FR Freeze 
HO Hold 2. 
IN Interp intée preter 
IT Intrinsic.Name . 
ee oa neice yee ctor” 
Mesory rr 
QV Override 
PR Priority 
SC Schedule. Priority 
SW Switch 
TH Then © fo ats 
UC Unconditional 
| UF Unfreeze 
« UV Unoverride — 
- VI Virtual .Disk 


e 6 
oOo 
“” 


o 6 © © 8 © 8 oe oe eo ee e46 
B -4 
m 


System Control Instructions | 
AX Response to ACCEPT | 
BF Display BACKUP. files (US) 
CP Compute. — : 
CU Core usage: . 
DF Oate of. file. cus) 
OM = Dusp memory and continue 
OP Ouap memory and discontinue 
DS Discontinue program 
FN Display internal fite name | 
FR Finat reet of unlabeled tape file 
FS force from schedule 
- GO Resume stopped program 
HS) Hold in waiting schedule ne eo, ere 
HW Hold in waiting schedute until job E0J | 
Close output file with purge  — 
MX Display MIX 
OF Optionat file response 
. OK Continue processing 
-e QOL Display peripherat status 
—e@ PD ‘Display directory — 
—  « PY Print mesory duap 
@ PR Change priority — 


eevee eG ae oe 8 8) 
© 
be 


eo 8 6 6 
Ooxrz 
co 
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System Control Instructions (cont inuec) 


« PS Prod schedule. 
io QF Query file CUS) 
° QP Query program 
- #3 Remove backup ites (US) 
- %>FM Kemove duplicate disk file 
-« RS Femove jobs fron schedule 
- SP Change schedule priority 
« ST Suspend orocessing 
- SW Set switch 
- 0D Time and date 
ee TI Time interrogation 
- TS Test switches | | 
ee UL ASSIGN. unlabeled file 
- WO Sisnotay wCP date | | 
. WY Cisolay current MCP and irterpreter 
—« =WwWS - splay schedule. - | : 
« WT fCisplay MCF time 
- WY Program status interrogation 


Joo Spawning Control Attributes | 


« QU Queue command 
« US  Usercode command 
» @@ Zip queue command | 


MIX retated MCP commands may refer oanty tc jobs initiated by the. 
Same remote terminal where the tnittal command was input. Alf 
MCP commands must be entered tn UPPER CASE...-. | 
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APPENDIX G2 PARAMETERS FILE ATTRIGUTES 


The PARAMETERS” ‘file is a disk file, data type with one physical 
record of 189 characters. This parereter necore 1s Toreeeted. 
as shown below. | : 


Record Format 


Dad Length Defauit | | 
Field en © Be bits) | Vatue — Descriction 


Filler — 05 wo. Renter See Seay eee 


a | = bytes). ) 


STATION.ID. . « PG" jee ‘Systee identifier; 17 bytes. 
STATION.ID-LENGTH 24 oO Length of system identifier. — 
| NAX.BUFFER.SIZE Rh 00k Transfer buf fer size. 


| REC. SIZE is 2h | 180 Waxieus record size. “for: RJE- | 
_ a es ee message block transaissions. 


TIMEOUT. INTERVAL 24 0 A vakue for. message display 
| _ | ae | intervals. — 7 


AUDITING 1 ———<~*sssSCD BUG oN/Off Switch. Default 
a et | - | of "C0" inhibits trace List. 


— QUE.?P 3a, * © When “set"» this parameter. 


 peraits Bett i me oS 


“COMMUNE ACNONS:: | 
NOFIP.P | | > oe : _ 680 To be specified. 
‘NOFS — _ _ ~*~ os # 7 — 0 To be speci fied. 
 WAIT.P he be 0 4 To shutdown or. not. ‘ehurdouns 
S we & Su: * Foe - —— when receiving a “disconnect 


message" from another SYCOM. 
oO shutdowns 1 = idle. — 
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Filter 
MY.J98-NO 


Filler 


 COMPILE.DATE 


Fitler 


(COMPILE.TIME | 


Filler 
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Reserved for 


Length Default | 
Cin bits) Value Descriction | 
3 000 keserved for future use. 
240 SYCCM's names 39 bytes. 
32° SYCOM'S “job ams 4 bytes. 
126 Reserved for identifier. 
Te is Compite date as “dd amm yy"3 | 
128 " Reserved for identifier. 
&9 7 Compile time as “hhrmmiss.t® 
| C19 bytes). ~ 
334 


future use.s.c. 
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"APPENDIX Hi SUPMARY OF FILES 


Program Internat Name “Ekternat. Name Device Use Size 


; Om Ome wee a mee ee ee mem ewes me a a Gn Gh a ae Ch om ee @ Sean aean amow a 


az sep. ere 


Cor iginat Cee 


SYCOM 


—RJECARDS. 


RJEPUNCH 


 RJEPRINT 


LINK 


LINE 


IN 


out 


TERMINALS” 


ING 


gute 


LINK.@ 


FIP.QUEUE 


RIJESQ 


FP 


CARDS 


SYCOM/NC 


“sucs” | 


ie Hees 


** Note? 


LINK | 


faint 


LINE. 


‘efile name>se 


RJE/CARDS 
RJE/PUNCH 

RJE/PRINT 
LINK 


efile name>*s | 


TERMINALS 


~ syconsINe 


SYCON/OUTQ 


SYCOM/LINK. Q 


SYCoMse TP. QUEUE 


SYCOM/RJE. Q 
SYCOM/PARAMETERS 


° hapos - 


LINK 


_NCSQUEVE 


‘Reader IT 


 Punch® 0 


Printer® 0O- 


Remote ‘1/0 
“Disk/Tape 1 
 Disk/Tape O varies — 
Queue 1/0 
- Queue = ‘1/0 
Queue 1/0 
Disk(R) 1/0 
Queue 1/0 


‘Disk = 1/0. 


Reader I 


‘Remote 1/0 
Remote a, | | 


| ‘Peinter or printer backup disk file. 


80s 


“B07 


132/1 


4555/1 


13271 


varies 


(se0s1 


seu, 
2000/1 
354/18 
“455s1 oes 
80/1 


 BOst 
45571 


ABSAL 


The actual file name as “specified in the cory command. 
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APPENDIX [2 SAMPLE APPLICATION PROGRAMS 


This program was designed basically to test “program-to-program® 
communication functions of SYCOM. What this sample anpoltication 


program orovides is the mechanics of what is necessary for 
communicatton process. The user can expand upon this sampl 
create a oroqram with the destred canabilities as required. 


tris 
e to 
The | 


program is written in UPL which is available for this purpose. 


The onty data communication tyne functions required for thi 


File and "write" reply messages into the same Remote File. 
message interfacing architecture has heen established for t 
purpose and must te» therefores adhered tc et atl times. 


PROGRAM-TO- PROGRAM. (User. System) 


TT Oe cent OO DE OD ED SD OEP EO ee ure aa a Ne Na aed et ws a oa OS ee aoe Na a et Sala ae ae ce 


: mn «wwe <3 we a oe 
ae. ape ee eee we a a EO GRR aR ER DO ED Dm ee cape ere, a we ome ee re te Ee ee ee re Ee eee te ee ee 


COMPILE USER/TEST UPL LIS 


This application program tests program-to-program 


ne 


po FP Bo GO 


x 
% communication using SYCOMs tn tne "LSER SYSTEM™. coe 
NETAIL 
SIZE -. | | ere 
R EXPAND_DEFINES XREF XMAP oe % Cuser optional) 
PASS END H&S . | , | 7 | 
FILE RFUSER CCEVICE = REMOTE» NUMBER_CF_STATIONS = 1» 
| - REMOTELKEYs RECORDS = 8C/1> BUFFERS = 2)3 
OEFINE CH AS ACHARACTERRS 
DECLARE TEXT 2 CH (80)> 


REPLY CH C8093 


s type 


of application program is to “read” input messages from a Remote 


This 
his. 
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DECLARE 2 RMT_KEY = = ss CH COD 
_ = 2 RMT_RSN CH C 3)» 


«2 ORMT_LENGTH CHC 4) 
2 RMTLTYPE © si Be 


4 READLKEY | CH C10)» 
2 READ_RSN CH C 3)» 
2 READ_LENGTH CH © 4D 
2 READ_TYPE - CH C 3s) 


RMT_RSN := "QOL" ; % First station in "family". 
— RMTLLENGTH c= "90080"; | % Standard message length. 
RMT_TYPE 2= "O000%s —  & MCS type cooe. a a 
OPEN RFUSER INPUT» OUTPUTS | 
DO TEST_LGOP FOREVER? 
ACCEPT TEXTS 
% Could check for speciat ‘input message for EQS stuff. 


Cutputs messages. 
Girectly to the | 
Network Controtler | | 
for delivery to the | 
ere vere nea an 


“WRITE RFUSER CRYT_KEY! (TEXTS 


Nan Nw 


READ RFUSER CREADKEY] CREPLYDS 2 
| | | % for the. Network 
2 Controller. 
ON EOF STOP? - «In case of “ace 
DISPLAY REPLYS 
END TEST_ Loop; 


% The above: program loop. wide never ends it must be DS'd. 
FINIZ : | YY 


anid nestiinnandipensatinnasalliteruediiucsedinemsndile onadli credit adiersad nae Hike ncadlle. corte: de sce dieasdllt- caste naditeanalfrsealltemedienencdlie osuliinncditemethoanariiiecsdih-cenaliiercadiieanedlh-cennthencndienandihennadiiceantiorendiiionamadeanaalienaadinenradiionndiagnetinaeebenardianaatincmdtinsedinasditnoatttnedinnsnadioanedinametinvanedtiiast-ctizradinseetitnandiinendppasdiiiasrdicme, Aimed 


Obtains input directly a 
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| PROGRAH-T0- “PROGRAM (server system) 


-00 inne se cme nm me me eee my een een ne ee ee ee ee 


Te ee, ee ee ee ee ee ee ee 


—COMFILE SERVER/TEST UPL LIS | 


hn This sample application program tests program- to-program 
We communication estoy, SYCOMs in the "SERVER SYSTEM"... 
ay A ee es ek ee ee Pe ry 7 

8 CETAIL 
8 SIZE °. 

& PASS_END | - : | 
FILE. RF SERVER (DEVICE = REMOTE» NUMBER. GF_ STATIONS a oe 
haf 7 PEMOTE_KEY> RECORDS — BC/1> BUFFERS = 2)3 
DEFINE CH 7 AS BCHARACTERKS 

DECLARE TEXT CH (80). 

OL RMTLKEY CH COD 

2 RMTI_RSN CH CO 3)e 

2 RMT_LENGTH | CHC 4)Yo 

2 RMT_TYPE ae CH C5 )e 

1 REAC_KEY 7 CH C10). 

2 READ_LRSN CH (€ 3)» 

2 READ_LENGTH CH € 4)> 

2 READ_TYPE . 4 CH € 323. 
RMT_LKSN f= "COL"? = - %& First station in "family" 
RMT_LENGTH ¢= "O008G"s  &£ Standard message Length 
RMT_TYPE z= NOhws ~~ x MCS type coge 


OPEN PFSERVER INPUT, OUTPUT? | 


— PO TEST. ‘Loop FOREVER: | , . OT 
| READ RFESERVER CRE AD_ KEY) CTEXT)5 % Input from User AP 
GN ECF STOP; In case of "9C*%... 
WRITE RF SERVER ie (TEXT); % OQutput to User aP > 

ENO FEST PSE « | 7 . : oo 


~ 


% The above procran loop will never ends it must be DS*d. 
ENE? 


SECTION VII 


GLOSSARY 


81200781709 SYSTEMS COMMUNICATIONS MODULE 12 Sep 1978 


Software Oper ational Guide | a — Page - 147 


Section VII Glossary of Terms and Acronyms —  CAriginal. Version) 


SECTION VII 


GLCSSARY OF TERMS 


ma a ma a a ee a Oe em a am a Ge a ah & OO a 


This qlossary defines SYCOM terms and acronyms used. throughout 
this software operational guide. For ease of user the glossary 
is separated into two sectionss Terms and Acronyyxs. Each section 
is sequenced alphabetically for quick reference. | 


TERMS 


mm ee wwe Re Bhan ew eee wwe & 2 = DH om « 


ACTIVE STATION: 


AMERICAN STANDARO © 
CODE FOR INFORMATION 


INTERCHANGE CASCII)?. 


APPLICATION PROGRAM: 


DEFINITION 


A work station (terpinat) that 4s 


currently eligible fer entering or. 
ed MESSAGES | 


This code» established by the American. 
Standards Assoctaticn» defines codes for a 
set of characters to be used in the tnter- 


change between business equipment over 


telephone and telegraph circuits. The code 
consists of 128 graphic and controt a 
characters. 


A program that processes data and is 
unique to une type cf application. It is 
sometimes referred tc aS a “user program". 
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eR Se ee DEFINITION 


i aed alle ube ea, ee: A. dev cee furnished: by the communications 
eee common carrier which atlows a User System. 
to automaticaily establish a diated link — 
to a Server system: over. a communications an 
network. , 


BEGINNING OF JOB a. + 
. _ CBO): The ‘ékeéution of a single program unit to | 
-y “« ~ 2e-be performed by the SUSE . : | 


BINARY CARD: = =—A pinched card with sultiple punches. in | 
i any one or more cotuans which pepessent a 
nonwASCIi SraE acter _ | | 


BIT: | ~s ~The smattest unit of inforaation in a 
| a. ae | binary oy steus | | 


“BITS PER SECOND (tps): The e: expression bits- pense cone: is. aieed- te 


express the speed at which bits of. ORG at Hees 


are trans@itted over a communication 
channel or internally moved Within a 


= oeeapatae:, system. : 


—ptock: == 
es -_ go ihe a single unit of data. Also» see Block 
Check Character. 7 | os 


BLOCK CHECK CHARACTER 7 | | | | : 
| ECCS The ‘Block Check bande ter is a character: 
| appended to data blocks transmitted for an 
the purpose of error detection and parity | 
es age — ne 


BLOCKING FACTOR: “The maxiaua nisber of characters “allowed 
a ae My gt eo eee: transmission. — 


BROADCAST: a The Sicbivancéus dissemination: ae 


dub a sheebcters/4 ite. transmitted ae 


_ information to a number of work stations a ee 


_ (terminals). 


BL800/P17909 SYSTEMS 


COMMUNICATIONS MODULE = = «12. Sep 1978 


Software Operational Luide > - : a | Page -_ 189 
section VII Glossary of Terms and Acronyms (Original Version) 


TERM 


BUFFER: 


CARFIAGE CONTROL: 


CHANNEL: 


CHARACTER? | 


COMMON CARRIER: 


COMMON CARRIER: 
EXCHANGE 


COMMUNICATION LINE: 


CONDITIONED LINES? 


CONNECTION: | 


DEFINITION 


This ts temporary stcrage that is used 


during the transfer cf data from one 
device to another. It ts also used to 
compensate for variations in bit rates or. 
timing of events within the system. 


Controls the vertical paper motion for a 
Line orinter. ; | | 


of device that directs the flow of data 


between a computer’s main nemory and 
input/output devices. 


A cigit» letter» or special character o- 


(Letters can be upper or lower case.) 


A companys such as Bell Telephones that 


provides communication Atnes as a public 


service. 


A defined areas served by a communications 
carriers within which the carrier provides 
service. | 


Any medium» such as a wire or a telephone | 
circuit, that connects a terminal with the 
computer. | 3 : | 


These are private ana teased transmission. 
lines that are concitioned to reduce data | 
distortion while providing transmission. o f 
data at neuer error rates. 3 


An established data transmission path 
tetween two or more computer systems. It 


is considered either a temporary or 


permanent connections depending on whether 


it is established with/without Switching 
facilities» respectively. 
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TERA i a _. DEFINITION 

suite: canis: ee A punched card which contains information _ 


which identifies a job or describes its 


requirements to the MCP. The first coluan — 


must contain an invalid character in 80 
~ column cards» a question mark “2” in 96 | 
coluan cards» or a rutl character 2000 for. 
remote jobs. 


CONTROL STATE: -The term "control state"» for this. system, 
| a ee y refers to a program that can assume 
control of the systea's processor with 
privileged operands. As arutes the type 
of control state program suggested here 
infers an "operating systea” or HCP. 


CONVERSATIONAL MODE: An operational mode in which message data | 

= | «6 Cfullo or partial sgessages) is used in lieu 
ore or in addition to» controt characters - 
as tepties for message: information. | 


DATA: a : | Pata. is any representation of inforsation> 
| | | such as characters» to which. weaning atone 
be. ee VINeas, = 


DATA COMMUNICATIONS: oats ‘Edueuiieacien is a method ae 
SO transferring encoded data by means of 
eleétrical transaission between two or 
terminals and/or systems. 


DATA COMMUNICATIONS | | 
~ 3 SYSTEM: A data communications system consists of 
two or more computer systems that. are 
Linked by means of a communication — 
line(s) for the purpose of data exchange. 


DATA LINK: | i A composite of computer systems and the 
: oo eterconnecting networks together with 
control procedures» operating in a | 
particular mode that permits in formation 
to be. exchanged between these eVetee Se a. 
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TERM DER INITION 
DATA SET:  ———s | A aevice that provides an inter face 


between a data communications system and 

a data communicatiors line. Most data 

communication lines use a modulated 

carrier for data transfer. The data set 

provides the logic tc modify the data fron 
being received or transmitted between 

Per MLAs and the system. 


DATA SET READY? = —A_ Signal provided by the Data Set.. 


DATA TRANSMISSICN: | Data transmission consists of transmitting 
| | ee a Gata between two or sore computer systems 
tn a ‘System network. | 


DISCONNECT C(DEQT): | The term Cand mnemcnic) for the “DLE EQT" 
a ss communication contretl sequence which is 
_ used to signal that a “disconnect” of a 

switched circuit must ke initiated. | 


DIAL-OUT: a The use of an Auto Call Unit to establish | 
| a 7 a “Switched” connection between two (2) 
computers. | a 


DIAL“UP: r The use of a dial or touchtone data set to 
4 | establish a "switched" connection between 
| two (2) computers. | | | : 


DISK CARTRIOGE: A seicondsny data storage. device much the 
7 “77s * ss Same as a "disk. pack" but usually. smatler 
in size. [t can be moved on-line or 
off-line. : 


DISK DIRECTORY: © A disk-resident table that contains the 
~~. —— ; 3 name and type of file» together with a 
pointer to the disk file header or sub- 
directory for all nermanent files which 

reside on disk. 7 : 


| DISK PACK: 2 A secondary data storage devices that can 
a a i ee ae be moved on- line or off- ‘line. | 
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‘ait ee ees OEFINITION. 


——enseernerroeyr tae 


i eas An iddntifier “which: is the. nage assigned 
—. toa ‘disk pack or disk cartridge. | 


EXTENDED BINARY CCDED 
. DECIMAL INTERCHANGE eee a a ee ee ee oo ee ee 
CODE CEBCDIC): ~~ A due: consisting of 6- ‘bits which. is used. 

tn a 2 -* «to represent 256 unique letters» numbers> 
and Special characters. Be, Syeok 


a ERROR? as ay received character or sequence of 


characters that does not conform to. those | 


transmitted are considered to be in error. © 


ERROR RECOVERY sis | O 7 
PROCEDURES? ‘Thesé are data. communication control 
oo oa “procedures used to restore normal 


 ° operations toa data tink after an error 
-_ has. occurred. | 


FAMILY NAME? nt 2 identifier. used as a file names or the — 


nawe. assigned to identify a main file with 


; subdirectory entries. — 


FILE SECURITY: | The: bedéedures” or special Wevicces used. to 
| oe prevent access to or use of data or 
programs without authorizations. 


FILE IDENTIFIER: | Atl disk file-identifiers used on the 


system must be unique to prevent duplicate 


file-names. A fite identifier can be | 
corprised of any cortination of the. 
following eaters Cee ert yer options: 


7 Aite=saenti tier = 
i. family-nane/file-identi fier | 
ie dprid/family~name/file-identi fier 


~ HALF=DUPLEX CHANNEL: _ This is a communication channel in which - 
Ae, cy YP ketone oth i PE signating may be in either directions —. 
‘ oUt not in both directions sigultaneousty.— 
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HALF7DUPLE X 
TRANSMISSION: | 


HARD COPY: 


LDENTIFIER? | 
INTEGER: 


 INTER=“SYSTEM 
— COMMUNTCATIONS: 


INTRA=SYSTEM 


COMMUNICATIONS: | 


“JOB: 


JOB NUMBER: 
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DEFINITION 


This 1s a type of data transmission where 
information 1s sent in onty one direction 
at a time. [t cannot send data in both 
directions simultarecusly. 


Generally» the printed copy of some. 
material in a readable form ts considered 
to be "hard copy". This would include 
computer orinted media such as Reports, 
Listings» ard Documents like this. 


A word consisting cf (poe one to seventeen 
alphabetic» numericr or special characters 


in combination. 


A whole number as opposed to a fraction} 


that is» a number that contains the unit 
of Cone) an exact nuaber of. times. 


The ability for a terminal or program in 


one system to communicate with a program 
in another ee 


The restricted ability for a terminal or 
‘program in a system to communicate with 
another program in the Same system. | 


A "job" to this system is any program that 


is executable under: the control of the 


MCPs SYCOM ts a jok. 


A untque number asstcned by the systems 


MCP to each job that ts executed under its 
control. | a | 
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TeRW fe a es ae DEFINITION. : 
JOB aia! - -. The: abitity for a user to execute ote 


under program controt and maintain an | 
adequate tevel of controt over these jobs. 
pL EneNe execution. | | 


KE YBOARD: - _ A device. for the encoding of data by. vey. | 
_— os ss depressions which causes the generation of : 
the ‘Selected code elegent . | | 


LEASED LINE: — - a | data transmission err reserved “ae “Ke 


exclusive use of a ‘customer “Gate center). 


LIKE SYSTEMS A "Like Ayeteun ae: a system with physical | 
6 42° =~ a characteristics similar to those of a 
‘target system. For a 681800/81700 systems 

a "Like™ systema. would be either a B1800 or. 

ae ee 7 


LINE? AK dats communications Line linking two (2) — 
_ oy & a Oe oe g computers or a computer and its: esse vated: 
terminals. / 


LINE ADAPTERS A Like ee eon ces heeauare and/or 

| oe software logic used to interface a data _ 

set of communications line into a multi- 
Line or eyogten tune 1/0. controt untt. 


LINE SWITCHING: the Per haidus of terporarily connecting. 
[4 mS se two communications tines together so that _ 
two computers and/or a computer and its | 
. associated terminats can exchange data. 


LOG-OFFS - The procedure by which a user ends a nae 

: | L exchange session either between two 
computers or between a computer and a 
terminal. - * s 


LOG-ONS a The ctocedire By ‘which a user establishes 
rr a cae i a Gata exchange session between tuo. 7 
p ronPaeee: or a COBDMERS, and a terminal. — 


“areoosaizoc SYSTEMS COMMUNICATIONS MODULE 7 oo AZ Sep 1978 


“Software Gperationat Guide a ; > Page - 195 
. Seetion VII. Gkossary of Terms a 7 Coriginat Version) 
TERM DEF ENT TEN 


- LOGICAL. STATION NUMBER | : | 
| (LSND: The identification number | assigned by the 
Network Controtter to a given. Station. 
(Terminal). The Logical Station Numter | 
has no relationship to file namess but ts 
determined by the croaer tn whitch a station. 
is defined in the Network Controtter. 


MASTER CONTROL PROGRAM | : & he gy Fe LY 5s 
CMCP D2 The Master Controt Program is the master. 
“control state” pregram Coperating system) 
used in the B1BA0/E1700° series computers 
for ‘systen control. | | 


MESSAGE? oo | A sequence of characters arranged in a 
— “gee  ~ 3 form suitabte for the purpose of conveying 
information. A message contains the data 
to be conveyed (the text) and mays in 


addition» contain comsunication characters _ 


to aid in the routing or handling of pale 
_ message. | | — 


MESSAGE FORMAT: A message format defines the piacemere of 
| oP ia message elements within the message text. 
These elements would te such items ass — 
header» control characters» and text data. 


MESSAGE HEADER: = = Every message moved tetween a terminal and 
| - “, & a — the SMCS» or an application program for 
that matters is prefixed. with a “header” 
This header contains station attributes | 
necessary to identify the station when the — 
time comes to returr a reply message. 


MESSAGE NUMBERING? | Message numbering is the sequencing of 

ee a —_ - messages transmitted by the communications 
system to ensure alt messages sent are in 

ts hee ew Cas. | | | 


MODEMS - Same as Data Set. 


«LANGUAGE CNDL ): ~ oA 4 
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TERA ae ek Cate DEFINE TION aa 
murine: TOENTIFIER te 2 
| CHE aoe Pas generalization for a group of files with 
. the same “famtty nage* but with eUtrerens 
file names. 


MULTI“LINE CONTROL | os | | | | 
cae  €MLCDS The. MLO) is an 170 gontrot jeqice: that. 
= a provides the functional controt. between 
computer hardware and the line. adapters. 
The control is an irtegral part of a 
aultistine comaunications sub-systea. 


NETWORKS res fiuabar. of data communication lines. 
So ta. a. Sige 2S - connecting the User System with remote. 
work stations Cteretnets) <> 3 | 7 


NETWORK CONTROLLER: The NDE weneraced data cegaunieacion =. 
a oh: * Se* program used by the. SYCOM to interface 


with. the work stations (terminats) and 
other ey st eess 


| NETWORK DEFINITION ie ee | no pce 
dhiptives. de cee foca language» “tor 
_ defining and implementing a data 
commtinications network. The NOL compiter 
analyzes the input statements and | 
| denvestes a ‘custos Networ k Controtter. 


NORMAL STATE: a The: iéce “noreal Seater s for 5 tented, * 


generally refers tc a program which has no ~ 


facilities to seize control of a system's 
processors as opposed to “control state”. 
C@eger SYCOM is a nor@al state program. ie 


OFFLINE: — ss There are two facets to this tera for the 


 S§YCOM. systems i) a system is “offtline™ 
. when no communications link currently — 
exists between tt anc a host systems. and 


Ppa systems terminals SPO» or program feo 


"offline™ when it is not logically _ Ee net 
-. connected to an application pucgces ain oe 
eo myetens | 7 a a 
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ONLINE? = oo There are. two “meanings for this term in a 


SYCOM systems 1) a system is “online™ when 
a communications Link currently exists 
between it and a hcst system that provides | 
processing services» and 2?) a terminal, 
SPO» or program in a User. System is 
“online” when it is togicatly connected to 
an application procraw in a host system. 
(The system must be online in order for a 
terminal» SPO» or program to be ontine.) 


PARTICIPATE: | This term refers to a function tin the. 

a | Supervisory Message Control System (SMCS) 
which allows it to “participate” in all 
input/output messace traffic between the 
Network Controller. ard an application 
‘program. In reference to a SYCOM system» 
the SMCS "is not permitted” to participate 
in SYCOM’s message traffic. 


PASSWORD: | gs, A unique string of characters that a 
ee _ programs computer operatcr» or user must 
supply to meet security requirements | 
before gaining access to data/fites. The 
password 15 confidertial as opposed to the. 
"usercode™. | Oe | 


POINT- TO-POINT a a oe a : a fee 
CONNECTIONS = — This ts a configuration in which a network 
| = connection is established between two» and 
only two» computers. The connection may 
include a switching facility. 


PRIVATE LINE: This woud te a data communications Line 
| | .  - which has been furnished to the user for 
exclusive USE. 7 


PSEUDO CARD READER: In a 81800/81700 system» a oseudo card 
3 | | reader is in fact a cisk fite.s. The disk 
file may be created via cards» program | 
outputs or via a terminal. When a program 
requires an input card file» the pseudo 
card reader can be substttuteds as that. 
fite can be approoriatety latretled. 
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TERN” a" DEFINITION 
ek as =k Vodleat Gollection of messages awaiting 


transaission. or. processing. = 


REMOTE JOBS | Subaission of chanted statements and data 
| ,* & 7 from a remote station (terminal /coaputer)>. 
causing the job described to be scheduled 

and executed at another Sys tees Af 


REMOTE JOB ENTRYCRJE)S The. feaote Job Entry progran is a method 
rn |  -be which a remote cosputer executes or 
compiles. programs sent to it by other. 

. computers; which are cons ider ed terminal 

‘eeu eee es, | : 


REMOTE SUPERVISORY ~ Cae eee ee eee 7 a ne 
CONTROL STATION CRSC): This is an input/output device tocated on 
oe “ce User System Cremote to a Server System) 
to provide the operator with the ability. 


to controt jobs and to request information — 


from the. Server System. 


RJE/TERMINAL? — ‘vie official name for the software. system 
FS “es ss froli which SYCOM derived its basic | 
capabilities. 


RJE STATIONS F of thie: systems the terms "RIE Station" 
| a and “User System” are equivatent. The new 
tera. is used to denote a system with many 
additional. capabilities and potentials 
 therefores the term "RJE Station" is no 
ionger appropriate. 


RELATIVE STATION. Tg ee a eee 
NUMBER CRSNDS Is the position within the Remote File 
ne  tamtilys assigned at generation time. 


SEMANTICS: == ~—__:‘The relationship between symbols and theirs 
on te | , MeanIngss: © ss | 7 | pi 


«SERVER SYSTEM: so Server system is a passive systen which 
pp awides computing services to the. eset: 
— Sveteaes tacaliv ar rematelyv. |. 
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SESSION: . The period of time during khich a user 


engages in dialog tetween a terminal and a 
cognputer or between two computers. (The 
elapsed time betweer when the user togs-on 
the system and when the log-off occurs. 


SESSTON NUMBER | A unique number assicned by a originating 
a — , 3 aystes to each» sesstcn. — | 


SINGLE LINE CONTROL | ce ng eo | | 
OSLO DE This is an 170 oneeet. device that. | 
 prevides the functional control between a 
- corputers main frawe and a tine adapter. 
— This controt is an integral part of a | 
—. single Line coamunications sub-systems.  . 


SITE IDS » 2 - UUOW unique 17-character identifier sent in a | 
os 7 | | special message to a. server system orior 
to being. logged-on to provide a positive | 
means of identifications independent of 
any other System a 


spos | _ 7 The accepted term for the 81800781700 
| 7 9 syste@s “supervisory console" (VDT or | 
Teletype). This term has been derived 
-- from the obsotete acronym for “Supervisory 
Printer Output". Usage in this document 
1s for an. abbreviaticn TOF Meee Spo. 


SPO LOG: 2 2 2 2 2 A oisk’ file that contains att TROL one put 


messages sent to ane received from the 
User SPQ. 
. SPOOLING: 3 | The aside cndeart was 67 input/output _ 


data streams on seccrdary storage devicese 
ina format conveniert for later output. 
operations and/or ‘processing. an 


STATION: = = Saw as “TERMINAL™.. 
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TERK ee DEFINITION. 


save daicoo 7% communications Nane: in which a wader 


- connection between. a User System and a 
se Server ayers: is established by i 


SWITCHINGS == This is. an errs rr invotving the inter= ; 
| ee gannecting of circuits in order to 
establish a temporary communication Link. 
between two or more systems. | 


SYNCHRONOUS | oe a oe oy ay. f 

TRANSMISSIONS | - 7 nN dati transmission ‘process. in which the 

«| a ee co. ts sending and receiving devices are . 
operating continuously at substantially. 
the same frequency and are maintained» by) 
means of correction» ina desired phase 7 
relationship. — 


“SYSTEM DISK: = = OA disk ik or disk cartridge that is ise 
a es a ~ initialized as a system pack. A system 


pack is under controt of the MCP and Bee 


or more must be present on the systea for. 
the. NCP to function. Head~per~ track disk 
is. always conser cere ea disk. | - 


TERMINAL: ee this. is an input/output device designed to. 


both receive and send source data in an — 
environment associated with the job to be 
performed. Further» it is capable of. 
-sending entries to» and obtaining outout | 
froms the system of which it is a part. 


OTEXTs A sequence of characters foraing to : 
_ ot -7 information to be conveyed. | 


TRANSMISSION? sane ae oat tanetanans 


— TRANSMISSION BLOCK: A. transaission ‘block may ‘contain atl eee es, 
ae ef a message block. A transmission — 
_. block is independent of the message(s) 
from which its denAnaGrers. are takens 
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TRANSPARENT MODES An operational mode in which att coded 


combinations of etght-bit characters are 
allowed as message text characters. 


UNIT DEVICE IDENTIFIER — _ i | | 
7 Cudi): The mnemonic identifier assigned to each 
peripheral device attached to the system. 


USER SPQ: © The User System's Supervisory Control 
: | ‘  & * station (VDT). : 


USER SYSTEM: A User System is the active participant | 
| » & di | system providing local. service to the user 


wishing to utilize arother computing 
resources pecetey or HOROLONY = 


USERCODE: | a, ere which consists of pcow one to. 
; eight characters tc eeee et the user. 


VIRTUAL TERMINALS © A logical communications capability which 
| _ permits a terminals SPQ» or program in one 
system to “itnteract™ with an. application 

program in another ell | 


VOT: | Video ee eciae A video type wor k 
| _ e «it station (terminal). such as the. TO820 and | 
TNa3G terminal devices. 


WAITING SCHEDULE? 7 Contains the names ard run-time attributes 
eee a | a of jcbs that are ae Venn: to be placed into 
the Active Seuecules : | > of 


21P:) | A method by which a program such as SYCOM> 
| 7 communicates with the MCP for certain. 
specific. “CP. functicrse 
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ACRONYMS 


ACU. 


AP 


ASCII 


BCC 


bpi 
pss. 


 ~oO0 


dp~id 


Fos 
1/0 


isn 


MCP 


NC 

NoL 

NIF 
 RJE 

—RSN 

SNCS = 

$06 

spa 

wale 

iced 
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Auto Calt Unit 


“Application Progras 


American $tandard Code ep Information 
Interchange , 


Block check Character 


‘Beginning of Job 

- Bits. Per Saéond 

Sata set 

“Direct | Oistance Dialing 
Disk Pack ‘Identifier 

End of Job” 


| Input/Output 


Logical, Station Nueber.- 7 


Master contrat Progr aa — 


Network Controtter 


Network Definition Language, 


Network Inforaation File 
Remote Job. Entry 

| Relative Station Nueber 
Supervisory. Message Control: Syston 
Software Cperational Guide . 
"Supervisory Printer Output 

Systeas Communications Module 


Unit Device Identifier 
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DOCUMENTATION ON ENHANCEMENT TO SYCOM 


1) When SLAVE/BACKUP is running asé=*=4 all backup files wiil be sent 
to the HUB and printed automatically. These backup files will then 
be removed from the sending system. Thus to print and remove backup 
files no operator/user intervention is required. 


If you do not want a backup file printed be sure to set the 
"NO ATP" attribute for the file. 


Example: 


CO HUB LSDL LI: FI LINE NO ATP; FI CARDS NAME HUB/SOURCE DSK; 


2) The PUT, FETCH and COPY syntax has been extended as follows: 


~PuUT Kfile name> (nist, REMOVE) 


eFETC ee 
COPY (NO LIST, SAVE) 
or 


(NO LIST, REMOVE) 
or 


(LIST, SAVE) 


The attribute LIST implies that the file will be printed at the receiving 
end. This attribute is applicable to Backup files only. 


The attribute REMOVE will cause the file to be removed from the sending 
system. 


The default attributes for Backup files are (LIST, REMOVE). The default 
attribute for non Backup file is SAVE. The LIST attribute does not apply 


to non Backup files. 
The PUT, COPY, FETCH systax is unchanged except for the above additions. 
Examples: | 
-PUT (SPO)/#4170 (SAVE) ONTO BACKUP.PRT/4170 
-PUT HUB (REMOVE) ONTO SYCOM3. 
-~PUT HUB (US=SP0/X, REMOVE) AS XYZ 


3) Program to SYCOM communication has been fixed so that a program can 
initiate .CONNECT. 


4) Many ¢hanges have been made to the SYCOM request section to prevent 
garbage messages and 16St messages. 
c ma Co 
S) Conf \ dole 
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